mcpField
A
apple-reminders

apple-reminders

github.com/nousresearch生产力258.5k370 次安装今天更新
代码仓库

关于 apple-reminders

apple-reminders 是一项技能，通过命令行工具 remindctl 在 macOS 上管理 Apple Reminders。它涵盖查看和整理列表、创建与更新提醒，以及设置截止时间和通知闹钟。

主要功能

  1. 01按日期和状态查看提醒
  2. 02创建、编辑、完成和删除提醒
  3. 03创建和管理提醒列表
  4. 04分别设置截止时间与闹钟
  5. 05读取 JSON、纯文本和计数输出

适用场景

  1. 01添加带截止时间的个人任务
  2. 02在提醒到期前设置提前通知
  3. 03查看逾期或即将到期的提醒
  4. 04整理 Apple Reminders 列表中的任务

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nousresearch/hermes-agent --skill apple-reminders

安装后在 Claude Code 中输入/apple-reminders确认已加载。

详细介绍

Apple Reminders

使用 remindctl，可直接从终端管理 Apple Reminders。任务会通过 iCloud 在所有 Apple 设备间同步。

前提条件

  • macOS，并安装 Reminders.app
  • 安装：brew install steipete/tap/remindctl
  • 出现提示时授予 Reminders 权限
  • 检查：remindctl status / 请求授权：remindctl authorize

适用场景

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

不适用场景

  • 安排 Agent 提醒 → 改用 cronjob 工具
  • 日历事件 → 使用 Apple Calendar 或 Google Calendar
  • 项目任务管理 → 使用 GitHub Issues、Notion 等
  • 如果用户说“提醒我”，但指的是 Agent 提醒 → 先澄清

快速参考

查看提醒事项
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:00，并要求提前 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"

Reminders 界面可能会按闹钟时间显示或归类该事项，因为通知会在此时触发。请通过 JSON 确认，而不要假设截止时间已更改：

remindctl today --json

预期结构：

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

Apple 公开的 EKReminder 文档仅列出提醒事项专属属性。闹钟支持来自继承的 EKCalendarItem 行为，并由 remindctl 的 --alarm 标志提供。

完成／删除
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）

规则

  1. 用户说“提醒我”时，先确认是指 Apple Reminders（会同步到手机）还是 Agent cronjob 提醒
  2. 创建前务必确认提醒事项内容和截止日期
  3. 使用 --json 进行程序化解析

评论

支持 Markdown