apple-reminders

# Apple Reminders CLI (remindctl) Use `remindctl` to manage Apple Reminders directly from the terminal. ## When to Use Use when: - User explicitly mentions "reminder" or "Reminders app" - Creating personal to-dos with due dates that sync to iOS - Managing Apple Reminders lists - User wants tasks to appear in their iPhone/iPad Reminders app ## When NOT to Use Do not use when: - Scheduling OpenClaw tasks or alerts -> use `cron` tool with systemEvent instead - Calendar events or appointments -> use Apple Calendar - Project/work task management -> use Notion, GitHub Issues, or task queue - One-time notifications -> use `cron` tool for timed alerts - User says "remind me" but means an OpenClaw alert -> clarify first ## Setup - Install: `brew install steipete/tap/remindctl` - macOS-only; grant Reminders permission when prompted - Check status: `remindctl status` - Request access: `remindctl authorize` ## Common Commands ### View Reminders ```bash 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 ``` ### Manage Lists ```bash remindctl list # List all lists remindctl list Work # Show specific list remindctl list Projects --create # Create list remindctl list Work --delete # Delete list ``` ### Create Reminders ```bash remindctl add "Buy milk" remindctl add --title "Call mom" --list Personal --due tomorrow remindctl add --title "Meeting prep" --due "2026-02-15 09:00" ``` ### Complete/Delete ```bash remindctl complete 1 2 3 # Complete by ID remindctl delete 4A83 --force # Delete by ID ``` ### Output Formats ```bash remindctl today --json # JSON for scripting remindctl today --plain # TSV format remindctl today --quiet # Counts only ``` ## 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`) ## Example: Clarifying User Intent User: "Remind me to check on the deploy in 2 hours" **Ask:** "Do you want this in Apple Reminders (syncs to your phone) or as an OpenClaw alert (I'll message you here)?" - Apple Reminders -> use this skill - OpenClaw alert -> use `cron` tool with systemEvent ## PilotDeck Migration Note - Source: /var/folders/27/xyyzc_n172l3jjmnxgqmhhzh0000gn/T/tmp.AyWDWGKoS4/openclaw/skills/apple-reminders - Review status: candidate for PilotDeck native skills pack. - Platform-specific OpenClaw/Hermes metadata was removed or should be ignored during review.