Introduction
# Apple Reminders CLI (remindctl)
Use `remindctl` to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.
Setup - Install (Homebrew): `brew install steipete/tap/remindctl` - From source: `pnpm install && pnpm build` (binary at `./bin/remindctl`) - macOS-only; grant Reminders permission when prompted.
Permissions - Check status: `remindctl status` - Request access: `remindctl authorize`
View Reminders - Default (today): `remindctl` - Today: `remindctl today` - Tomorrow: `remindctl tomorrow` - Week: `remindctl week` - Overdue: `remindctl overdue` - Upcoming: `remindctl upcoming` - Completed: `remindctl completed` - All: `remindctl all` - Specific date: `remindctl 2026-01-04`
Manage Lists - List all lists: `remindctl list` - Show list: `remindctl list Work` - Create list: `remindctl list Projects --create` - Rename list: `remindctl list Work --rename Office` - Delete list: `remindctl list Work --delete`
Create Reminders - Quick add: `remindctl add "Buy milk"` - With list + due: `remindctl add --title "Call mom" --list Personal --due tomorrow`
Edit Reminders - Edit title/due: `remindctl edit 1 --title "New title" --due 2026-01-04`
Complete Reminders - Complete by id: `remindctl complete 1 2 3`
Delete Reminders - Delete by id: `remindctl delete 4A83 --force`
Output Formats - JSON (scripting): `remindctl today --json` - Plain TSV: `remindctl today --plain` - Counts only: `remindctl today --quiet`
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`)
Notes - macOS-only. - If access is denied, enable Terminal/remindctl in System Settings → Privacy & Security → Reminders. - If running over SSH, grant access on the Mac that runs the command.