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 (fas