From e7615c464a01c863db219b168306bf8cfa6698d3 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sun, 4 Jan 2026 01:33:47 +0100
Subject: [PATCH] docs: update apple-reminders skill for remindctl

---
 skills/apple-reminders/SKILL.md | 72 ++++++++++++++++++++++-----------
 1 file changed, 48 insertions(+), 24 deletions(-)

diff --git a/skills/apple-reminders/SKILL.md b/skills/apple-reminders/SKILL.md
index f2fc083d9..28e2b65b4 100644
--- a/skills/apple-reminders/SKILL.md
+++ b/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.
-homepage: https://github.com/antoniorodr/memo
-metadata: {"clawdis":{"emoji":"⏰","os":["darwin"],"requires":{"bins":["memo"]},"install":[{"id":"brew","kind":"brew","formula":"antoniorodr/memo/memo","bins":["memo"],"label":"Install memo via Homebrew"}]}}
+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: {"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`
-- Manual (pip): `pip install .` (after cloning the repo)
-- macOS-only; if prompted, grant Automation access to Reminders.app.
+- 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
-- 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`
-  - Opens interactive prompt to create a reminder.
-- Quick add: `memo rem -a "Buy groceries"`
+- 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
-- Mark reminder as done: `memo rem -c`
-  - Interactive selection of reminder to complete.
+- Complete by id: `remindctl complete 1 2 3`
 
 Delete Reminders
-- Delete a reminder: `memo rem -d`
-  - Interactive selection of reminder to delete.
+- Delete by id: `remindctl delete 4A83 --force`
 
-Examples
-- Add a quick reminder: `memo rem -a "Call dentist tomorrow"`
-- List all reminders: `memo rem`
-- Complete a reminder: `memo rem -c` (then select from list)
-- Delete a reminder: `memo rem -d` (then select from list)
+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.
-- Requires Apple Reminders.app to be accessible.
-- For automation, grant permissions in System Settings > Privacy & Security > Automation.
-- The `memo` CLI shares the same installation for both Notes and Reminders functionality.
+- 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.