Command Reference

Complete reference for every Remind command, flag, and option.

remind add

Create a new reminder. By default, AI will enhance the text with better phrasing, suggested timing, and priority.

$ remind add <text> [OPTIONS]

Arguments

text (required): The reminder text. Accepts natural language.

Options

Flag	Short	Description	Default
`--due`	`-d`	Due date/time in natural language	now
`--priority`	`-p`	Priority: `high`, `medium`, `low`	medium
`--project`	`-P`	Project context tag	none
`--no-ai`		Skip AI suggestion	false

Examples

# Simple reminder
$ remind add "buy groceries"

# With due date and priority
$ remind add "review PR #234" --due "friday 5pm" --priority high

# With project tag, no AI
$ remind add "deploy to staging" --project work --no-ai

remind list

Display reminders in a formatted table. Shows active (not done) reminders by default.

$ remind list [OPTIONS]

Options

Flag	Short	Description
`--all`	`-a`	Include completed reminders
`--priority`	`-p`	Filter by priority level
`--json`	`-j`	Output as JSON

Examples

# Active reminders
$ remind list

# Only high-priority
$ remind list --priority high

# All reminders as JSON (for piping)
$ remind list --all --json | jq '.[].text'

remind done

Mark a reminder as complete by its ID.

$ remind done <reminder_id>

Arguments

reminder_id (required): The numeric ID of the reminder to complete. Find IDs with remind list.

Examples

$ remind done 1
  ✓ Done: Buy groceries

$ remind done 42
  ✓ Done: Ship v2.0 release

remind search

Full-text search across all reminder text.

$ remind search <query> [OPTIONS]

Arguments

query (required): Search term. Matches against reminder text.

Options

Flag	Short	Description
`--json`	`-j`	Output as JSON

Authenticate with your license token. Required for paid plan features.

$ remind login <token>

Arguments

token (required): License token starting with remind_. Get one at remind.hamzaplojovic.blog/pricing.

Examples

$ remind login remind_indie_abc123xyz789
  ✓ Logged in successfully
  PLAN               Indie

remind settings

View and modify configuration. See Configuration for all available keys.

$ remind settings [OPTIONS]

Options

Flag	Short	Description
`--view`	`-v`	Show all settings as JSON
`--set`	`-s`	Set a key=value pair

Examples

# View summary
$ remind settings

# See all settings
$ remind settings --view

# Disable AI
$ remind settings --set ai_rephrasing_enabled=false

remind scheduler

Manage the background notification service. Requires Indie plan or higher.

$ remind scheduler [OPTIONS]

Options

Flag	Description
`--status`	Show current scheduler status
`--enable`	Start background notification service
`--disable`	Stop background notification service

remind doctor

Run diagnostic checks on your Remind installation. Verifies database, configuration, license, and permissions.

$ remind doctor

Output

remind.
DIAGNOSTICS
────────────────────────────────────────────
  DATABASE           ✓ connected
  CONFIGURATION      ✓ valid
  LICENSE TOKEN      ✓ authenticated
  REMINDERS          ✓ accessible

────────────────────────────────────────────
  ✓ All checks passed.

See Troubleshooting for interpreting results.

remind report

Show usage statistics and productivity insights. Requires authentication.

$ remind report [OPTIONS]

Options

Flag	Short	Description
`--format`	`-f`	Output format: `table` (default) or `json`

remind upgrade

View available plans and your current tier. Directs you to the web dashboard to manage billing.

$ remind upgrade

remind uninstall

Remove Remind configuration from your system. Reminders are preserved in the database.

$ remind uninstall [OPTIONS]

Options

Flag	Short	Description
`--yes`	`-y`	Skip confirmation prompt

Warning

This removes configuration and disables the scheduler. Your reminders are preserved in ~/.remind/ and can be accessed after reinstalling.

Getting Started

Configuration