AgentSkillsCN

apple-reminders

通过 macOS 上的 `remindctl` CLI 管理 Apple 提醒事项（列出、添加、编辑、完成、删除）。支持列表、日期筛选器和 JSON/纯文本输出。

SKILL.md
--- frontmatter
name: apple-reminders
description: Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
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 Reminders CLI (remindctl)

Use remindctl to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.

Setup

  • •Install (Homebrew): brew install steipete/tap/remindctl
  • •From source: pnpm install && pnpm build (binary at ./bin/remindctl)
  • •macOS-only; grant Reminders permission when prompted.

Permissions

  • •Check status: remindctl status
  • •Request access: remindctl authorize

View Reminders

  • •Default (today): remindctl
  • •Today: remindctl today
  • •Tomorrow: remindctl tomorrow
  • •Week: remindctl week
  • •Overdue: remindctl overdue
  • •Upcoming: remindctl upcoming
  • •Completed: remindctl completed
  • •All: remindctl all
  • •Specific date: remindctl 2026-01-04

Manage Lists

  • •List all lists: remindctl list
  • •Show list: remindctl list Work
  • •Create list: remindctl list Projects --create
  • •Rename list: remindctl list Work --rename Office
  • •Delete list: remindctl list Work --delete

Create Reminders

  • •Quick add: remindctl add "Buy milk"
  • •With list + due: remindctl add --title "Call mom" --list Personal --due tomorrow

Edit Reminders

  • •Edit title/due: remindctl edit 1 --title "New title" --due 2026-01-04

Complete Reminders

  • •Complete by id: remindctl complete 1 2 3

Delete Reminders

  • •Delete by id: remindctl delete 4A83 --force

Output Formats

  • •JSON (scripting): remindctl today --json
  • •Plain TSV: remindctl today --plain
  • •Counts only: remindctl today --quiet

Date Formats Accepted by --due and date filters:

  • •today, tomorrow, yesterday
  • •YYYY-MM-DD
  • •YYYY-MM-DD HH:mm
  • •ISO 8601 (2026-01-04T12:34:56Z)

Notes

  • •macOS-only.
  • •If access is denied, enable Terminal/remindctl in System Settings → Privacy & Security → Reminders.
  • •If running over SSH, grant access on the Mac that runs the command.