reminders

# reminders Manage Apple Reminders from the command line. ## Installation If the `reminders` CLI is not installed, install it: ```bash brew install cardmagic/tap/reminders # or npm install -g @cardmagic/reminders ``` **Requirements:** - macOS with Apple Reminders - Node.js 22+ - Full Disk Access for terminal (System Settings > Privacy & Security > Full Disk Access) ## Triggers Use this skill when user asks about: - Viewing reminders, tasks, or todos - Adding or creating reminders - Completing or marking tasks as done - Grocery lists or shopping lists - What's due soon or overdue **Proactive triggers:** "reminders", "tasks", "todos", "grocery list", "add reminder", "remind me", "mark done", "complete task", "what's on my list", "due soon" ## Browse Commands ```bash # Show pending reminders (default) reminders # Show all reminder lists with counts reminders lists # Show reminders in a specific list reminders list "Groceries" reminders list "Work" --all # include completed # Show pending/completed/flagged reminders pending reminders completed reminders flagged # Show reminders due within N days reminders due --days 7 ``` ## Create Reminders The `add` command auto-detects the appropriate list based on content: ```bash # Auto-detects list from content reminders add "Buy milk" # → Groceries list reminders add "Call mom" # → Family list (if exists) # Specify list explicitly reminders add "Review PR" --list "Work" # With due date reminders add "Doctor appointment" --due 2024-01-15 reminders add "Morning standup" --due tomorrow --time 09:00 # With priority and flags reminders add "Urgent task" --priority high --flagged # Full options reminders add "Project deadline" --list "Work" --due 2024-02-01 --priority high --notes "Final review" ``` ## Complete Reminders The `done` command marks reminders as completed: ```bash # Search all lists for matching reminder reminders done "Buy milk" # Search in specific list (faster) reminders done "meeting notes" --list "Work" ``` ## Search Commands ```bash # Fuzzy search across all reminders reminders search "milk" # Filter by list or status reminders search "meeting" --list "Work" reminders search "groceries" --pending reminders search "project" --completed ``` ## Options Reference | Option | Description | Example | |--------|-------------|---------| | `--list, -l` | Filter by list name | `--list "Groceries"` | | `--due, -d` | Due date (YYYY-MM-DD, today, tomorrow) | `--due tomorrow` | | `--time, -t` | Due time (HH:MM) | `--time 09:00` | | `--priority, -p` | Priority level | `--priority high` | | `--notes, -n` | Add notes | `--notes "Don't forget!"` | | `--flagged, -f` | Mark as flagged | `--flagged` | | `--pending` | Show only pending | `--pending` | | `--completed` | Show only completed | `--completed` | | `--all, -a` | Include completed | `--all` | | `--days` | Days to look ahead | `--days 7` | ## Tips - Use quotes around titles with spaces: `reminders add "Buy groceries"` - The `done` command uses fuzzy matching - partial titles work - Auto-detect works best with clear keywords like "groceries", "work", "family" - Rebuild index after bulk changes: `reminders index`