Commands

Complete reference for every rem CLI command: rem add, rem list, rem complete, rem delete, rem update, rem search, rem stats, rem today, rem overdue, rem upcoming, rem export, rem import, rem interactive, rem lists, rem list-mgmt, rem flag, rem skills, and more.

Global flags

These flags work with every command:

Flag	Description
`-o, --output`	Output format: `table`, `json`, or `plain`
`--no-color`	Disable colored output
`-h, --help`	Show help for any 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

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.

Flag	Description
`-l, --list`	Target list (default: system default list)
`-d, --due`	Due date (natural language or standard format)
`-p, --priority`	Priority: `high`, `medium`, `low`, `none`
`-n, --notes`	Notes/body text
`-u, --url`	URL (shows in Reminders.app URL field)
`-f, --flagged`	Flag the reminder
`--remind-me`	Custom alarm: duration before due (`15m`, `1h`, `2d`) or absolute time
`--silent`	Don’t auto-attach an alarm when `--due` is set
`--repeat`	Set recurrence: `daily`, `weekly`, `monthly`, `yearly`, or `weekly on mon,wed,fri`
`-i, --interactive`	Step-by-step interactive creation

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

Flag	Description
`-l, --list`	Filter by list name
`--incomplete`	Show only incomplete reminders
`--completed`	Show only completed reminders
`--flagged`	Show only flagged reminders
`--due-before`	Reminders due before this date
`--due-after`	Reminders due after this date
`-s, --search`	Full-text search in title and notes

`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

Aliases: edit

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

Flag	Description
`--name`	New title
`-l, --list`	Move reminder to a different list
`-d, --due`	New due date
`-p, --priority`	New priority
`-n, --notes`	New notes
`-u, --url`	New URL (empty string to clear)
`--flagged`	Set flag: `true` or `false`
`--remind-me`	Set alarm: duration (`15m`, `1h`, `2d`), `none` to clear
`--repeat`	Set recurrence: `daily`, `weekly`, `monthly`, `yearly`, `none` to clear
`-i, --interactive`	Interactive update

`rem complete`

Mark a reminder as completed.

rem complete 6ECE

Aliases: done

`rem uncomplete`

Mark a completed reminder as incomplete.

rem uncomplete 6ECE

`rem flag` / `rem unflag`

Toggle the flag on a reminder.

rem flag 6ECE
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

Flag	Description
`--force` / `--yes` / `-y`	Skip the confirmation prompt

Search & Analytics

`rem search`

Full-text search across title and notes.

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

Flag	Description
`-l, --list`	Search within a specific list
`--incomplete`	Search only incomplete reminders

`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

Flag	Description
`-l, --list`	Filter by list name

`rem overdue`

Show all overdue incomplete reminders.

rem overdue
rem overdue --list Work

Flag	Description
`-l, --list`	Filter by list name

`rem upcoming`

Show reminders due in the next N days.

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

Flag	Description
`--days`	Number of days to look ahead (default: 7)
`-l, --list`	Filter by list name

Lists

`rem lists`

View all reminder lists.

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

Flag	Description
`-c, --count`	Show reminder count per list

`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

Flag	Description
`-l, --list`	Export from a specific list
`--format`	`json` or `csv` (default: json)
`--output-file`	File path (default: stdout)
`--incomplete`	Export only incomplete reminders

`rem import`

Import reminders from JSON or CSV.

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

Flag	Description
`-l, --list`	Import into this list (overrides source list)
`--dry-run`	Preview what would be created without creating

Interactive Mode

`rem interactive`

Launch a full interactive menu.

rem i

Aliases: i

The menu includes:

Create reminder (guided prompts)
List reminders
Complete a reminder
Delete a reminder
View all lists
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
rem skills install --agent claude          # Claude Code only
rem skills install --agent openclaw        # OpenClaw only
rem skills install --agent all             # All agents

Flag	Description
`--agent`	Target agent: `claude`, `codex`, `openclaw`, or `all` (default: interactive picker)

`rem skills uninstall`

Remove the rem agent skill.

rem skills uninstall --agent claude

Flag	Description
`--agent`	Target agent: `claude`, `codex`, `openclaw`, or `all` (default: interactive picker)

`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:

Pattern	Example
Relative	`in 2 days`, `in 3 hours`, `in 30 minutes`, `5 days ago`
Named	`now`, `today`, `tomorrow`, `yesterday`
Day of week	`monday`, `next monday`, `next friday`
Special	`eod` (5pm today), `eow` (Friday 5pm), `this week`, `next week` (next Monday), `next month` (1st of next month)
Compound	`next friday at 2pm`, `tomorrow at 3:30pm`, `today 5pm`, `monday 2pm`
Month-day	`mar 15`, `21 march`, `december 31 11:59pm`
Time only	`5pm`, `17:00`, `3:30pm`
ISO 8601	`2026-02-15`, `2026-02-15T14:30:00`
US format	`02/15/2026`, `2/15`
Named month	`Feb 15`, `February 15, 2026`

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

Commands

Global flags

Reminders

rem add

rem list

rem show

rem update

rem complete

rem uncomplete

rem flag / rem unflag

rem delete

Search & Analytics

rem search

rem stats

rem today

rem overdue

rem upcoming