Apple Reminders
Manage Apple Reminders lists and due-dated to-dos from the terminal so tasks sync to iPhone and iPad while you ship solo.
Overview
Apple Reminders is an agent skill for the Operate phase that manages Apple Reminders and lists through the remindctl CLI on macOS.
Install
npx skills add https://github.com/steipete/clawdis --skill apple-remindersWhat is this skill?
- Lists, adds, edits, completes, and deletes reminders via remindctl
- macOS-only integration with native Reminders permission flow
- Homebrew install path: steipete/tap/remindctl
- Explicit boundary vs OpenClaw cron, Calendar, and Notion/GitHub task tools
- Triggers when users mention Reminders app or iOS-synced personal to-dos
- macOS-only; requires remindctl binary
- Homebrew formula: steipete/tap/remindctl
Adoption & trust: 2.4k installs on skills.sh; 378k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want terminal-driven todos that sync to your iPhone Reminders app without mixing them up with agent cron alerts or work trackers.
Who is it for?
Solo macOS users who explicitly want Apple Reminders with due dates and cross-device sync from an coding agent.
Skip if: Linux or Windows builders, OpenClaw one-shot alerts (use cron), calendar appointments, or Notion/GitHub-style project task management.
When should I use this skill?
User mentions reminder or Reminders app, wants iOS-synced personal to-dos with due dates, or asks to manage Apple Reminder lists—not OpenClaw cron or calendar events.
What do I get? / Deliverables
Reminders and lists are created and updated via remindctl with correct macOS permissions, while non-Reminders scheduling is routed to cron or other tools after clarification.
- Updated Apple Reminders and lists via remindctl commands
- Clarified routing when user meant cron vs Reminders
Recommended Skills
Journey fit
Personal task hygiene sits in Operate—keeping reminders in sync while you iterate on shipping and support, not in early idea or launch distribution work. Iterate is the canonical shelf for day-to-day personal todos and follow-ups that do not belong in project trackers or agent cron alerts.
How it compares
Use for native Reminders sync—not as a general task queue or MCP-style calendar server.
Common Questions / FAQ
Who is apple-reminders for?
Indie builders and agent users on macOS who want remindctl to mirror personal to-dos into the Apple Reminders app on phone and tablet.
When should I use apple-reminders?
Use during Operate when iterating on personal follow-ups, when the user names Reminders or iOS-synced todos, or when creating due-dated items that must live in Apple’s Reminders—not for deploy monitoring or launch copy.
Is apple-reminders safe to install?
It requires installing remindctl and granting Reminders access on your Mac; review the Security Audits panel on this Prism page and only grant permissions you are comfortable with.
SKILL.md
READMESKILL.md - 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