reminders

What this skill does

# 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`