Getting Started

Install Remind and create your first reminder in under a minute.

Requirements

Python 3.12+ (if installing via pip)
macOS or Linux
Internet connection for AI features (optional)

Installation

uv (recommended)

The fastest way to install — isolated tool environment, no dependency conflicts:

$ uv tool install remind-cli

pip

Install from PyPI into any Python 3.12+ environment:

$ pip install remind-cli

Shell script

One-liner that detects your OS and installs the appropriate binary:

$ curl -fsSL remind.hamzaplojovic.blog/install | sh

From source

Clone the repo and install with uv:

$ git clone https://github.com/hamzaplojovic/remind.git
$ cd remind
$ uv sync --all-extras

Verify installation

$ remind --help
Usage: remind [OPTIONS] COMMAND [ARGS]...
Remind: AI-powered reminder CLI

Tip

Run remind doctor after installation to verify everything is working correctly.

Quickstart

1. Create a reminder

Use natural language. Remind parses intent, timing, and priority:

$ remind add "buy groceries tonight"
  AI  Buy groceries tonight at 7:00 PM
  ✓ Reminder saved (#1)

Add flags for more control:

$ remind add "review PR" --due "friday 5pm" --priority high

2. List reminders

$ remind list

  ID   TEXT                      DUE              PRI
   1   Buy groceries             tonight 7pm      MED
   2   Review PR                 Friday 5pm       HIGH

  2 reminders

3. Complete a reminder

$ remind done 1
  ✓ Done: Buy groceries

4. Search

$ remind search "PR"

  ID   TEXT                      DUE              PRI
   2   Review PR                 Friday 5pm       HIGH

  1 reminder

Optional: Authenticate

To unlock AI features beyond the free tier, log in with your license token:

$ remind login remind_indie_abc123xyz789
  ✓ Logged in successfully
  PLAN               Indie

Get your token at remind.hamzaplojovic.blog/pricing.

Optional: Enable background notifications

$ remind scheduler --run
  ✓ Scheduler started
  Checking every 1s

Note

The scheduler runs as a background process and delivers native OS notifications on macOS (AppleScript) and Linux (D-Bus).

Optional: Claude Code integration

Remind includes an MCP server with 7 tools for Claude Code. Add it to your .claude/settings.json:

{
  "mcpServers": {
    "remind": {
      "command": "remind",
      "args": ["mcp"]
    }
  }
}

Claude Code can then add, list, complete, search, update, and delete reminders — or schedule autonomous agent tasks.

Overview

Commands