Apple Reminders

• 您希望在不离开终端或切换到 GUI 应用的情况下，快速添加、完成或查看提醒事项。
• 您正在构建需要以编程方式读取或写入 Apple Reminders 的 shell 脚本或 AI 智能体工作流。
• 您需要从 Apple Reminders 获取结构化输出（JSON 或 TSV），以便输入到其他工具或流水线中。
• 您希望通过 SSH 在 Mac 上管理提醒事项，而无需打开 Apple Reminders 应用。

• 您不在 macOS 上——此工具仅适用于 Darwin 系统，无法在 Linux 或 Windows 上运行。
• 您使用第三方任务管理器（Todoist、Things、OmniFocus 等），而非原生 Apple Reminders 应用。
• 您需要在非 Apple 平台上查看 iCloud 同步状态；remindctl 仅在本地 macOS Reminders 数据库上运行。

通过 today（今天）、tomorrow（明天）、week（本周）、overdue（已逾期）、upcoming（即将到来）、completed（已完成）或指定的 YYYY-MM-DD 日期格式，快速筛选提醒事项。这样一来，无需编写任何查询逻辑，即可轻松构建每日简报或查看逾期未完成的内容。

使用 add 创建提醒事项，使用 edit 更新标题和截止日期，使用 complete 将一个或多个标记为已完成，并使用 delete --force 永久删除它们。所有操作均通过提醒事项的 ID 进行定位。

通过命令行查看所有 Apple Reminders 列表、显示特定列表中的提醒事项，以及创建、重命名或删除列表。

通过 --json 输出结构化数据管道所需的结果，通过 --plain 输出制表符分隔的值，或通过 --quiet 仅输出计数。这使得 remindctl 能够轻松集成到 Shell 脚本、自动化工具和 AI 智能体中。

在设置或按截止日期筛选时，支持自然语言简写（today、tomorrow）、YYYY-MM-DD、YYYY-MM-DD HH:mm 以及完整的 ISO 8601 时间戳格式。

在会话开始时运行 remindctl today --json，以结构化格式获取今日所有到期提醒，让 AI 代理将其与日历事件或消息一起进行汇总。

使用 remindctl add --title "Review PR" --list Work --due tomorrow 可以在不切换到 Apple Reminders 应用的情况下捕获任务，让你保持专注于终端。

运行 remindctl overdue 查看所有已逾期的事项，然后使用 remindctl complete 1 2 3 通过单条命令将多个提醒标记为已完成。

将 remindctl week --plain 通过管道传输到其他 Shell 工具或自动化脚本中，无需任何图形界面交互即可处理、筛选或汇报即将到来的 Apple Reminders 提醒事项。