docs: update apple-reminders skill for remindctl

skills/apple-reminders/SKILL.md

@@ -1,43 +1,67 @@
 ---
 name: apple-reminders
-description: Manage Apple Reminders via the `memo` CLI on macOS (create, complete, and delete reminders). Use when a user asks Clawdis to add a reminder, mark reminders as done, or manage their reminder list.
+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/antoniorodr/memo
+homepage: https://github.com/steipete/remindctl
-metadata: {"clawdis":{"emoji":"⏰","os":["darwin"],"requires":{"bins":["memo"]},"install":[{"id":"brew","kind":"brew","formula":"antoniorodr/memo/memo","bins":["memo"],"label":"Install memo via Homebrew"}]}}
+metadata: {"clawdis":{"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
+# Apple Reminders CLI (remindctl)
 
-Use `memo rem` to manage Apple Reminders directly from the terminal. Create, complete, and delete reminders with simple commands.
+Use `remindctl` to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.
 
 Setup
-- Install (Homebrew): `brew tap antoniorodr/memo && brew install antoniorodr/memo/memo`
+- Install (Homebrew): `brew install steipete/tap/remindctl`
-- Manual (pip): `pip install .` (after cloning the repo)
+- From source: `pnpm install && pnpm build` (binary at `./bin/remindctl`)
-- macOS-only; if prompted, grant Automation access to Reminders.app.
+- macOS-only; grant Reminders permission when prompted.
+
+Permissions
+- Check status: `remindctl status`
+- Request access: `remindctl authorize`
 
 View Reminders
-- List all reminders: `memo rem`
+- 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
-- Add a new reminder: `memo rem -a`
+- Quick add: `remindctl add "Buy milk"`
-  - Opens interactive prompt to create a reminder.
+- With list + due: `remindctl add --title "Call mom" --list Personal --due tomorrow`
-- Quick add: `memo rem -a "Buy groceries"`
+
+Edit Reminders
+- Edit title/due: `remindctl edit 1 --title "New title" --due 2026-01-04`
 
 Complete Reminders
-- Mark reminder as done: `memo rem -c`
+- Complete by id: `remindctl complete 1 2 3`
-  - Interactive selection of reminder to complete.
 
 Delete Reminders
-- Delete a reminder: `memo rem -d`
+- Delete by id: `remindctl delete 4A83 --force`
-  - Interactive selection of reminder to delete.
 
-Examples
+Output Formats
-- Add a quick reminder: `memo rem -a "Call dentist tomorrow"`
+- JSON (scripting): `remindctl today --json`
-- List all reminders: `memo rem`
+- Plain TSV: `remindctl today --plain`
-- Complete a reminder: `memo rem -c` (then select from list)
+- Counts only: `remindctl today --quiet`
-- Delete a reminder: `memo rem -d` (then select from list)
+
+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.
-- Requires Apple Reminders.app to be accessible.
+- If access is denied, enable Terminal/remindctl in System Settings → Privacy & Security → Reminders.
-- For automation, grant permissions in System Settings > Privacy & Security > Automation.
+- If running over SSH, grant access on the Mac that runs the command.
-- The `memo` CLI shares the same installation for both Notes and Reminders functionality.