$npx -y skills add SafeAI-Lab-X/ClawKeeper --skill apple-remindersManage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
| 1 | # Apple Reminders CLI (remindctl) |
| 2 | |
| 3 | Use `remindctl` to manage Apple Reminders directly from the terminal. |
| 4 | |
| 5 | ## When to Use |
| 6 | |
| 7 | ✅ **USE this skill when:** |
| 8 | |
| 9 | - User explicitly mentions "reminder" or "Reminders app" |
| 10 | - Creating personal to-dos with due dates that sync to iOS |
| 11 | - Managing Apple Reminders lists |
| 12 | - User wants tasks to appear in their iPhone/iPad Reminders app |
| 13 | |
| 14 | ## When NOT to Use |
| 15 | |
| 16 | ❌ **DON'T use this skill when:** |
| 17 | |
| 18 | - Scheduling OpenClaw tasks or alerts → use `cron` tool with systemEvent instead |
| 19 | - Calendar events or appointments → use Apple Calendar |
| 20 | - Project/work task management → use Notion, GitHub Issues, or task queue |
| 21 | - One-time notifications → use `cron` tool for timed alerts |
| 22 | - User says "remind me" but means an OpenClaw alert → clarify first |
| 23 | |
| 24 | ## Setup |
| 25 | |
| 26 | - Install: `brew install steipete/tap/remindctl` |
| 27 | - macOS-only; grant Reminders permission when prompted |
| 28 | - Check status: `remindctl status` |
| 29 | - Request access: `remindctl authorize` |
| 30 | |
| 31 | ## Common Commands |
| 32 | |
| 33 | ### View Reminders |
| 34 | |
| 35 | ```bash |
| 36 | remindctl # Today's reminders |
| 37 | remindctl today # Today |
| 38 | remindctl tomorrow # Tomorrow |
| 39 | remindctl week # This week |
| 40 | remindctl overdue # Past due |
| 41 | remindctl all # Everything |
| 42 | remindctl 2026-01-04 # Specific date |
| 43 | ``` |
| 44 | |
| 45 | ### Manage Lists |
| 46 | |
| 47 | ```bash |
| 48 | remindctl list # List all lists |
| 49 | remindctl list Work # Show specific list |
| 50 | remindctl list Projects --create # Create list |
| 51 | remindctl list Work --delete # Delete list |
| 52 | ``` |
| 53 | |
| 54 | ### Create Reminders |
| 55 | |
| 56 | ```bash |
| 57 | remindctl add "Buy milk" |
| 58 | remindctl add --title "Call mom" --list Personal --due tomorrow |
| 59 | remindctl add --title "Meeting prep" --due "2026-02-15 09:00" |
| 60 | ``` |
| 61 | |
| 62 | ### Complete/Delete |
| 63 | |
| 64 | ```bash |
| 65 | remindctl complete 1 2 3 # Complete by ID |
| 66 | remindctl delete 4A83 --force # Delete by ID |
| 67 | ``` |
| 68 | |
| 69 | ### Output Formats |
| 70 | |
| 71 | ```bash |
| 72 | remindctl today --json # JSON for scripting |
| 73 | remindctl today --plain # TSV format |
| 74 | remindctl today --quiet # Counts only |
| 75 | ``` |
| 76 | |
| 77 | ## Date Formats |
| 78 | |
| 79 | Accepted by `--due` and date filters: |
| 80 | |
| 81 | - `today`, `tomorrow`, `yesterday` |
| 82 | - `YYYY-MM-DD` |
| 83 | - `YYYY-MM-DD HH:mm` |
| 84 | - ISO 8601 (`2026-01-04T12:34:56Z`) |
| 85 | |
| 86 | ## Example: Clarifying User Intent |
| 87 | |
| 88 | User: "Remind me to check on the deploy in 2 hours" |
| 89 | |
| 90 | **Ask:** "Do you want this in Apple Reminders (syncs to your phone) or as an OpenClaw alert (I'll message you here)?" |
| 91 | |
| 92 | - Apple Reminders → use this skill |
| 93 | - OpenClaw alert → use `cron` tool with systemEvent |