title: “Apple Reminders — Apple Reminders via remindctl: add, list, complete” sidebar_label: “Apple Reminders” description: “Apple Reminders via remindctl: add, list, complete”

{/* 本页面由 website/scripts/generate-skill-docs.py 根据技能对应的 SKILL.md 文件自动生成。请直接编辑源文件 SKILL.md，而非此页面。 */}

Apple 提醒事项

通过 remindctl 管理 Apple 提醒事项：添加、列出、标记完成。

技能元数据


来源	内置（默认已安装）
路径	`skills/apple/apple-reminders`
版本	`1.0.0`
开发者	Hermes Agent
许可协议	MIT
支持平台	macos
标签	`Reminders`, `tasks`, `todo`, `macOS`, `Apple`

参考：完整的 SKILL.md 文件

:::info 以下是当触发该技能时 Hermes 会加载的完整技能定义。技能处于激活状态时，智能体将依据此内容执行操作。: ::

Apple 提醒事项

通过终端使用 remindctl 直接管理 Apple 提醒事项。任务会通过 iCloud 在所有 Apple 设备之间同步。

先决条件

安装了 Reminders.app 的 macOS 系统
安装工具：brew install steipete/tap/remindctl
按提示授予 Reminders 应用相应权限
检查状态：remindctl status / 请求授权：remindctl authorize

适用场景

用户提及“提醒事项”或“Reminders 应用”
创建带有截止日期的个人待办事项，并同步到 iOS 设备
管理 Apple 提醒事项列表
用户希望任务在 iPhone/iPad 上显示

不适用场景

安排智能体提醒 → 请使用 cronjob 工具
日历事件管理 → 请使用 Apple 日历或 Google 日历
项目任务管理 → 请使用 GitHub Issues、Notion 等工具
若用户说“提醒我”但实际上是指智能体提醒 → 需先明确需求

快速参考

查看提醒事项

remindctl                    # Today's reminders
remindctl today              # Today
remindctl tomorrow           # Tomorrow
remindctl week               # This week
remindctl overdue            # Past due
remindctl all                # Everything
remindctl 2026-01-04         # Specific date

管理列表

remindctl list               # List all lists
remindctl list Work          # Show specific list
remindctl list Projects --create    # Create list
remindctl list Work --delete        # Delete list

创建提醒事项

remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"

截止时间与提醒/提前提示

--due 和 --alarm 是两个不同的参数：

--due 用于设置提醒的截止日期和时间。
--alarm 用于设置 EventKit 的提醒/通知触发机制。对于定时截止的提醒，系统通常会在截止时间触发警报；但若用户希望提前收到提示，则需明确指定 --alarm 参数。

例如，设置一个在下午2点截止的提醒，并在30分钟前发送通知：

remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"

要编辑现有的提醒事项：

remindctl edit 87354 --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"

“提醒”界面可能会根据警报时间来显示或分组相关事项，因为正是到了该时间才会触发通知。建议通过 JSON 数据进行核实，而非擅自认定截止时间发生了变动。

remindctl today --json

预期格式：

dueDate：实际截止时间
alarmDate：通知或提前提醒时间

Apple官方的EKReminder文档仅列出了与提醒功能相关的属性。而警报功能则通过remindctl工具的--alarm参数所调用的、继承自EKCalendarItem的机制来实现。

完成/删除

remindctl complete 1 2 3          # Complete by ID
remindctl delete 4A83 --force     # Delete by ID

输出格式

remindctl today --json       # JSON for scripting
remindctl today --plain      # TSV format
remindctl today --quiet      # Counts only

日期格式

--due 参数及日期筛选器所支持的格式包括：

today、tomorrow、yesterday
YYYY-MM-DD
YYYY-MM-DD HH:mm
ISO 8601 格式（2026-01-04T12:34:56Z）

规则

当用户输入“提醒我”时，需明确说明是使用 Apple Reminders（同步至手机）还是通过代理程序的定时任务进行提醒。
在创建提醒之前，务必确认提醒内容和截止日期。
如需通过程序自动解析，可使用 --json 参数。

Keyboard shortcuts

Hermes Agent Docs i18n