viticci/remctl

解决的问题

RemCTL 提供了一个 macOS 提醒事项的命令行界面 (CLI)，使高级用户和 AI 代理能够以编程方式管理任务。它通过对提醒事项数据库提供快速、详细的访问，克服了标准 API 的限制，包括支持通过基本脚本通常无法访问的高级功能，例如分区、标签和智能列表。

工作原理

RemCTL 使用混合架构来平衡速度、权限和系统稳定性：

• 读取路径：它从本地 iCloud 提醒事项数据库执行直接的 SQLite 读取，以近乎即时地访问详细的元数据。
• 写入路径：它使用 Apple 公开的 EventKit API 来确保更改能正确同步到所有设备。
• 私有 API 路径：对于高级元数据（如子任务、标签和购物清单分类），它可以选择通过明确的 --private 标志使用私有的 ReminderKit 框架。
• 权限宿主：为了简化权限管理，大多数命令通过已签名的 RemCTL Capability Host.app 进行路由，该应用程序持有必要的“完全磁盘访问”和“自动化”权限，因此调用方的终端或代理不需要单独拥有这些权限。

适用人群

• macOS 高级用户：希望通过终端或 Shell 脚本管理提醒事项的用户。
• AI 代理：正在构建代理（例如使用 Claude Code 或 Codex）且需要可靠方式与用户任务列表交互的开发者。

亮点

• 深度集成：支持分区、子任务、标签、图片附件和自定义智能列表。
• 代理友好：提供 JSON 输出和结构化的命令映射，易于与 LLM 集成。
• 智能列表管理：能够根据优先级、日期或标志创建和编辑自定义智能列表。
• 购物清单支持：原生处理购物特定的元数据并自动分类。
• 灵活调度：支持类似自然语言的日期解析（例如 "tomorrow 3pm"、"+3d"、"eod"）。