名称： apple-reminders
描述： 通过 macOS 上的 remindctl CLI 管理 Apple 提醒事项（列出、添加、编辑、完成、删除）。支持列表、日期筛选以及 JSON/纯文本输出。
主页： https://github.com/steipete/remindctl
元数据： {"clawdbot":{"emoji":"⏰","os":["darwin"],"requires":{"bins":["remindctl"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/remindctl","bins":["remindctl"],"label":"通过 Homebrew 安装 remindctl"}]}}

Apple 提醒事项 CLI (remindctl)

使用 remindctl 直接在终端中管理 Apple 提醒事项。支持列表筛选、基于日期的视图以及脚本输出。

安装

• Homebrew 安装：brew install steipete/tap/remindctl
• 源码安装：pnpm install && pnpm build（二进制文件位于 ./bin/remindctl）
• 仅限 macOS；安装时按提示授予“提醒事项”访问权限。

权限管理

• 检查状态：remindctl status
• 请求访问权限：remindctl authorize

查看提醒事项

• 默认（今日）：remindctl
• 今日：remindctl today
• 明日：remindctl tomorrow
• 本周：remindctl week
• 已逾期：remindctl overdue
• 即将到期：remindctl upcoming
• 已完成：remindctl completed
• 全部：remindctl all
• 指定日期：remindctl 2026-01-04

管理列表

• 列出所有列表：remindctl list
• 显示特定列表：remindctl list Work
• 创建列表：remindctl list Projects --create
• 重命名列表：remindctl list Work --rename Office
• 删除列表：remindctl list Work --delete

创建提醒事项

• 快速添加：remindctl add "Buy milk"
• 指定列表和截止日期：remindctl add --title "Call mom" --list Personal --due tomorrow

编辑提醒事项

• 编辑标题/截止日期：remindctl edit 1 --title "New title" --due 2026-01-04

完成提醒事项

• 按 ID 完成：remindctl complete 1 2 3

删除提醒事项

• 按 ID 删除：remindctl delete 4A83 --force

输出格式

• JSON（适用于脚本）：remindctl today --json
• 纯文本 TSV：remindctl today --plain
• 仅显示数量：remindctl today --quiet

日期格式

--due 参数和日期筛选器接受的格式：
- today、tomorrow、yesterday
- YYYY-MM-DD
- YYYY-MM-DD HH:mm
- ISO 8601 格式（如 2026-01-04T12:34:56Z）

注意事项

• 仅限 macOS 系统。
• 如果访问被拒绝，请在“系统设置 → 隐私与安全性 → 提醒事项”中为终端/remindctl 启用权限。
• 如果通过 SSH 运行，请在执行命令的 Mac 上授予访问权限。