Start

Commands

GitHub Edit page

#Show reminders

remindctl today
remindctl tomorrow
remindctl week
remindctl overdue
remindctl upcoming
remindctl open
remindctl completed
remindctl all
remindctl 2026-01-03

Limit a view to one list:

remindctl show overdue --list Work
remindctl show overdue --list-id 7A12

Show multiple lists together:

remindctl list Work Errands

#Create reminders

remindctl add "Review notes"
remindctl add "Call Sam" --list Work --due tomorrow
remindctl add "Call Sam" --list-id 7A12 --due tomorrow
remindctl add "Take vitamins" --due tomorrow --repeat daily
remindctl add "Check mailbox" --location "1 Apple Park Way, Cupertino, CA"

Useful add options:

  • --list <name> chooses the target list.
  • --list-id <id-prefix> chooses the target list exactly.
  • --due <date> sets a due date.
  • --alarm <date> sets a notification alarm.
  • --notes <text> adds notes.
  • --repeat <rule> sets simple recurrence.
  • --priority <none|low|medium|high> sets priority.
  • --url <url> stores the EventKit URL and mirrors it into notes as remindctl URL (managed): ... so Reminders.app shows the link.
  • --location <address> creates an arriving geofence trigger.
  • --leaving changes a location trigger to leaving.
  • --radius <meters> adjusts the geofence radius.

#Edit reminders

remindctl edit 1 --title "New title"
remindctl edit 4A83 --due "2026-01-04 09:00"
remindctl edit 4A83 --clear-due
remindctl edit 4A83 --list Office
remindctl edit 4A83 --list-id 7A12
remindctl edit 4A83 --no-repeat

edit, complete, and delete accept indexes from the current default listing or ID prefixes.

Changing or clearing only the due date leaves every alarm unchanged. Explicit alarm edits preserve relative and location-based alarms while replacing or clearing absolute alarms.

#Lists

remindctl list
remindctl list Work
remindctl list Projects --create
remindctl list Work --rename Office
remindctl list OldList --delete --force
remindctl list --list-id 7A12
remindctl list --list-id 7A12 --rename Archive

Mutating list operations accept one list name. Read-only list views can accept multiple names. List names resolve by exact match, case-insensitive match, then a normalized match that ignores emoji and punctuation. If a name is ambiguous, use --list-id.

#Search and inspect

remindctl search "invoice" --list Work
remindctl search "project" --completed --json
remindctl info 1
remindctl info 4A83 --json
remindctl export --json
remindctl export --list Work --export-format csv
remindctl link 1
remindctl link --list-id 7A12
remindctl open 1
remindctl open --list Work
remindctl open --list Work --app
remindctl completion zsh

open --list Work keeps the historical open-reminders filter. Add --app to open that list in Reminders.app.

#Diagnostics

remindctl status
remindctl doctor --for-agent

#Output

remindctl all --json
remindctl list --json
remindctl today --plain
remindctl today --format table
remindctl status --json

Global output flags:

  • --json emits machine-readable JSON.
  • --plain emits stable tab-separated lines.
  • --format table emits tabular output.
  • --quiet emits minimal output.
  • --no-color disables colored output.
  • --no-input disables interactive prompts.