By name: apple-reminders
description: 在 macOS 上通过 remindctl CLI 管理 Apple 提醒事项（列出、添加、编辑、完成、删除）。支持列表、日期过滤以及 JSON/纯文本输出。
homepage: https://github.com/steipete/remindctl
metadata:
{
"openclaw":
{
"emoji": "⏰",
"os": ["darwin"],
"requires": { "bins": ["remindctl"] },
"install":
[
{
"id": "brew",
"kind": "brew",
"formula": "steipete/tap/remindctl",
"bins": ["remindctl"],
"label": "Install remindctl via Homebrew",
},
],
},
}
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,yesterdayYYYY-MM-DDYYYY-MM-DD HH:mm- ISO 8601 (
2026-01-04T12:34:56Z)
注意事项
- 仅限 macOS。
- 如果访问被拒绝，请在“系统设置 → 隐私与安全性 → 提醒事项”中为终端/remindctl 启用权限。
- 如果通过 SSH 运行，请在运行该命令的 Mac 上授予权限。