Commands

Global flags

These flags work with every command:

Reminders

rem add

Create a new reminder.

rem add "Buy groceries" --due tomorrow --priority high --list Personal
rem add "Review PR" --due "friday at 2pm" --remind-me 30m   # notify 30 min before
rem add "Checklist item" --due tomorrow --silent            # due date, no notification
rem add "Ship demo" --url https://github.com/BRO3886/rem/pull/24
rem add "Review PR #work #urgent" --tags "deploy"          # native tags
rem add "Buy milk" --location "37.3318,-122.0312" --radius 200   # geofence: on arrival
rem add "Take out trash" --location "37.3318,-122.0312" --on-leave

Aliases: create, new

Notifications. When --due is set, rem auto-attaches an alarm at the due time so the system actually fires a notification — matching Apple Reminders.app default behavior. Use --remind-me to override the timing (e.g. 15m for 15 minutes before), or --silent to suppress the auto-alarm entirely.

URLs. --url writes to the real Reminders.app URL field (not the notes body), so URLs show up with Apple’s native link card rendering in the Reminders.app UI.

Tags. #hashtags in the title are automatically parsed and stored as native Reminders.app tags. You can also pass tags via the --tags flag. Tags use the private ReminderKit API — if Apple changes it in a future macOS version, the reminder is still created successfully (tags just won’t be set).

Location triggers. --location "lat,lng" attaches a geofence alarm via public EventKit. It fires on arrival by default; pass --on-leave for departure and --radius (meters) to size the fence (0 = system minimum). Coordinates only — rem does no address geocoding. A reminder can carry both a due date and a location trigger. The geofence only fires on a device with Location Services enabled for Reminders (typically your iPhone).

The interactive form (rem add -i) has no --silent option. Reminders created interactively with a due date always get an auto-alarm. To create a silent reminder via the interactive flow, follow up with rem update <id> --remind-me none to clear the alarm.

rem list

List reminders with optional filters.

rem list --list Work --incomplete --due-before 2026-03-01

Aliases: ls

rem show

Show full details for a single reminder, including alarms and recurrence rules.

rem show 6ECE

Aliases: get

Pass the full ID, UUID, or any unique prefix. IDs are case-insensitive and prefix-matched.

rem update

Update an existing reminder.

rem update 6ECE --priority medium --due "next friday"
rem update 6ECE --url https://github.com/org/repo/pull/42
rem update 6ECE --url ""   # clear URL
rem update 6ECE --add-tags "work,urgent"    # add tags
rem update 6ECE --remove-tags "urgent"      # remove tags
rem update 6ECE --location "37.3318,-122.0312" --on-leave   # set/replace geofence
rem update 6ECE --location none                             # clear geofence only

Aliases: edit

--url writes to the native Reminders.app URL field (not the notes body). Pass an empty string (--url "") to clear.

--add-tags and --remove-tags accept comma-separated tag names. Tags in --title are also parsed as hashtags. Tags use the private ReminderKit API and degrade gracefully if unavailable.

--remind-me and --location manage separate alarm buckets: --remind-me replaces only time-based alarms, --location replaces only the geofence. --remind-me none clears time alarms but keeps the geofence; --location none does the reverse.

--list moves the reminder. Plain moves are native and keep the reminder’s ID. Moving to or from a shared list is different: macOS has no true move across that boundary (Apple’s own apps copy and delete behind the scenes), so rem copies the reminder — all fields preserved, including completed state — deletes the original, and prints a warning with the new ID on stderr. Because the ID changes, rem asks for confirmation before a shared-list move; pass --force/-f to skip the prompt (required in scripts — non-interactive runs refuse without it, same as rem delete). Re-resolve the ID after such a move.

rem complete

Mark one or more reminders as completed.

rem complete 6ECE
rem complete 6ECE A1B2 C3D4    # batch complete

Aliases: done

rem uncomplete

Mark one or more completed reminders as incomplete.

rem uncomplete 6ECE
rem uncomplete 6ECE A1B2

rem flag / rem unflag

Toggle the flag on one or more reminders.

rem flag 6ECE
rem flag 6ECE A1B2    # batch flag
rem unflag 6ECE

rem delete

Delete one or more reminders. Supports multiple IDs for batch deletion.

rem delete 6ECE
rem delete 6ECE A1B2 --force    # batch delete, skip confirmation

Aliases: rm, remove

Search & Analytics

rem search

Full-text search across title and notes.

rem search "quarterly review" --list Work --incomplete

rem stats

Show overall statistics.

rem stats

Displays: total count, completed, incomplete, flagged, overdue, completion rate, and per-list breakdown.

rem today

Show today’s due and overdue reminders.

rem today
rem today --list Work

rem overdue

Show all overdue incomplete reminders.

rem overdue
rem overdue --list Work

rem upcoming

Show reminders due in the next N days.

rem upcoming           # next 7 days (default)
rem upcoming --days 14 # next 14 days

Lists

rem lists

View all reminder lists.

rem lists
rem lists --count    # include reminder count per list

Shared lists are marked — (shared) in table output, [shared] in plain. JSON output carries three booleans per list: IsShared, SharedToMe (someone shared it with you), and IsOwnedByMe.

rem list-mgmt

Create, rename, or delete lists.

Aliases: lm

rem lm create "Projects"
rem lm rename "Projects" "Active Projects"
rem lm delete "Old List" --force

Note: Immutable system lists (e.g. Siri suggestions) cannot be renamed or deleted.

Import & Export

rem export

Export reminders to JSON or CSV.

rem export --format json --output-file backup.json
rem export --list Work --format csv
rem export --incomplete --format json

rem import

Import reminders from JSON or CSV.

rem import backup.json
rem import data.csv --list "Imported" --dry-run

Interactive Mode

rem interactive

Launch a full interactive menu.

rem i

Aliases: i

The menu includes:

1. Create reminder (guided prompts)
2. List reminders
3. Complete a reminder
4. Delete a reminder
5. View all lists
6. Create a new list

You can also use -i with add and update for interactive field entry.

Skills

rem skills install

Install the rem agent skill for AI coding agents.

rem skills install                         # Interactive picker (shows confirmation prompt)
rem skills install --agent claude          # Claude Code only
rem skills install --agent openclaw        # OpenClaw only
rem skills install --agent all             # All agents
rem skills install --dry-run              # Preview files without writing

rem skills uninstall

Remove the rem agent skill.

rem skills uninstall --agent claude

rem skills status

Show skill installation status across all supported agents.

rem skills status

Date Formats

Date parsing is powered by go-eventkit/dateparser. Supported patterns:

When a standalone time is given (like 5pm), it uses today if the time hasn’t passed yet, otherwise tomorrow.