reminders

提醒事项

将其用于 Apple 提醒事项任务。当用户想在 macOS 上使用适合 AI 的个人待办事项后端时，优先使用 rem，而不是 Things/AppleScript。

工具

• CLI：rem
• 仓库：https://github.com/BRO3886/rem
• 安装：

GOBIN=/opt/homebrew/bin go install github.com/BRO3886/rem/cmd/rem@latest

rem 使用 EventKit 执行常规读取和写入。调用该工具的应用可能需要在“系统设置”>“隐私与安全性”中获得“提醒事项”权限。

开始使用

检查访问权限：

rem lists -o json
rem today -o json

对于任何脚本操作或验证，使用 JSON：

rem list --incomplete -o json
rem search "flight" -o json
rem show <id> -o json

添加任务

默认操作：直接添加，然后通过搜索/显示进行验证。

rem add "Book LHR-SFO nonstop business flight" --due "tomorrow 9am" --priority high --notes "Nonstop only." -o json
rem search "LHR-SFO" -o json

常用标志：

• --list "Name"：目标列表
• --due "tomorrow 9am"：到期日期/时间；支持自然语言
• --priority high|medium|low|none
• --notes "text"
• --url https://...
• --silent：设置到期日期但不发送通知
• --remind-me 15m：在到期时间前设置闹钟
• --repeat daily|weekly|monthly|yearly

更新 / 完成 / 删除

先查找 UUID，然后按 id 或唯一短 id 修改：

rem search "flight" -o json
rem update <id> --name "New title" --due "friday 2pm" --notes "..." -o json
rem complete <id> -o json
rem delete <id> --force

写入后务必读取回确认；不要只依赖退出状态。

列表

rem lists --count -o json
rem list-mgmt create "Travel"
rem list-mgmt rename "Old" "New"
rem list-mgmt delete "Name" --force

约定

• 使用可执行的任务标题。将含糊的备注改写为下一步具体行动。
• 如果用户明确要求逐字记录，则保留其原有措辞。
• 将多个互不相关的操作拆分为单独的提醒事项。
• 除非用户指定列表或类别显而易见，否则使用默认列表。
• 不要在此处添加日历事件；请改用日历工具。
• 计算当前日期时，运行 date；不要猜测。

注意事项

• 仅适用于 macOS。
• 首次运行时可能会失败并显示 reminders access denied，直到调用该工具的应用获得“提醒事项”权限。
• 默认本地列表可能已本地化，例如 Erinnerungen。
• rem 搜索使用普通查询，不支持 shell 正则表达式。
• 除非传入 --silent，否则 --due 会在到期时间设置闹钟。
• 已标记的提醒事项在底层使用私有的 ReminderKit，与普通 CRUD 操作相比，可能更容易受到操作系统变化的影响。