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 Brigade tasks or alerts → use
crontool 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
crontool for timed alerts - User says "remind me" but means an Brigade 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
bashremindctl # 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
bashremindctl list # List all lists remindctl list Work # Show specific list remindctl list Projects --create # Create list remindctl list Work --delete # Delete list
Create Reminders
bashremindctl 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
bashremindctl complete 1 2 3 # Complete by ID remindctl delete 4A83 --force # Delete by ID
Output Formats
bashremindctl 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,yesterdayYYYY-MM-DDYYYY-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 Brigade alert (I'll message you here)?"
- Apple Reminders → use this skill
- Brigade alert → use
crontool with systemEvent

