remi — Apple Reminders CLI
All commands support --json for structured output. Requires macOS 13+ with Reminders access.
How to invoke
Run remi as a CLI command via Bash. If remi is not on PATH, use npx @mattheworiordan/remi instead. Always use --json when calling programmatically.
Commands
# Lists
remi lists # All lists
remi list "<name>" # Reminders in a list
remi list "<name>" --include-completed
remi create-list "<name>"
remi delete-list "<name>" --confirm
# Reminders
remi add "<list>" "<title>" # Simple add
remi add "<list>" "<title>" --section "<s>" --due 2026-04-15 --priority high --notes "..."
remi complete "<list>" "<title>"
remi delete "<list>" "<title>" --confirm
remi update "<list>" "<title>" --due 2026-05-01 --priority medium
# Sections
remi sections "<list>" # List sections
remi create-section "<list>" "<name>" # Idempotent
remi delete-section "<list>" "<name>"
remi move "<list>" "<title>" --to-section "<name>" # Assign to section
# Queries
remi today
remi overdue
remi upcoming --days 7
remi search "<query>"
# Diagnostics
remi doctor
JSON mode
Use --json for programmatic access. Returns {"success": true, "data": ...} or {"success": false, "error": {"code": "...", "message": "...", "suggestion": "..."}}.
Key behaviors
- Idempotent — creating an existing section returns success
- Title matching — case-insensitive; use
--id <prefix>if ambiguous - Sections sync to iCloud — changes appear on all Apple devices
--confirmrequired for delete operations in interactive mode (not needed with--json)