Getting Started

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

Requirements

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

Installation

Homebrew (macOS & Linux)

The recommended way to install on macOS and Linux:

$ brew 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

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 --enable
  ✓ Scheduler enabled
  Will check reminders every 5 minutes