Apple Reminders CLI(remindctl)是一个在 macOS 终端中直接管理 Apple Reminders 的命令行工具,支持列表过滤、基于日期的视图以及脚本化输出。
用途 用于从命令行对 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 上授予访问权限。
关于收费、价格、平台扩展或使用效果等信息,资料暂未提供。