Apple Reminders CLI (remindctl)

Use remindctl to manage Apple Reminders directly from the terminal.

When to Use

✅ USE this skill 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

❌ DON'T use this skill when:

• Scheduling Clawdbot 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 a Clawdbot 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

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

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

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

remindctl complete 1 2 3 # Complete by ID remindctl delete 4A83 --force # Delete by ID

Output Formats

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 a Clawdbot alert (I'll message you here)?"

• Apple Reminders → use this skill

• Clawdbot alert → use cron tool with systemEvent