Apple Reminders CLI (remindctl)

用法remindctl可直接从终端管理 Apple Reminders。它支持列表筛选、基于日期的视图和脚本输出。

安装设置

• 通过 Homebrew 安装：brew install steipete/tap/remindctl
• 从源码安装：pnpm install && pnpm build（二进制文件位于./bin/remindctl）
• 仅限 macOS 系统；当提示时，请授予 Reminders 权限。

权限

• 检查状态：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
• 纯文本制表符分隔格式：remindctl today --plain
• 仅计数：remindctl today --quiet

日期格式 以下格式可被--due和日期过滤器接受：

• 今天、明天、昨天
• YYYY-MM-DD
• YYYY-MM-DD HH:mm
• ISO 8601 格式（2026-01-04T12:34:56Z）

注意

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