remind-cli 1.3.3
A cross-platform CLI reminder and notification engine with AI-powered suggestions and smart nudges
License: MIT
Requires Python: >=3.12
Keywords: ai, cli, notifications, reminders, scheduler

# Remind CLI

[![PyPI version](https://badge.fury.io/py/remind-cli.svg)](https://pypi.org/project/remind-cli/)
[![Downloads](https://static.pepy.tech/badge/remind-cli)](https://pepy.tech/project/remind-cli)
[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/hamzaplojovic/remind/blob/main/LICENSE)

A terminal-native reminder engine with AI-powered suggestions, desktop notifications, and Claude Code integration.

Runs on **macOS** and **Linux**. Requires Python 3.12+.

---

## Installation

**Recommended** (isolated environment via [uv](https://docs.astral.sh/uv/)):

```bash
uv tool install remind-cli
```

**Via pip:**

```bash
pip install remind-cli
```

**One-line installer:**

```bash
curl -fsSL remind.hamzaplojovic.blog/install | sh
```

Verify the installation:

```bash
remind --version
```

---

## Quick Start

```bash
# Create a reminder
remind add "Deploy v2.0 to production" --due "friday 3pm" --priority high

# List active reminders
remind list

# Mark a reminder as done
remind done 1

# Search by keyword
remind search "deploy"
```

---

## Commands

| Command | Description |
|---------|-------------|
| `add` | Create a reminder. Flags: `--due`, `--priority`, `--project`, `--no-ai` |
| `list` | Show active reminders. Flags: `--all`, `--priority`, `--json` |
| `done` | Mark a reminder as complete by ID |
| `search` | Full-text search across all reminders |
| `login` | Authenticate with a license token |
| `register` | Sign up and purchase a plan via Polar checkout |
| `settings` | View or modify configuration. Flags: `--view`, `--set` |
| `usage` | View AI usage statistics for the current billing period |
| `scheduler` | Run the background notification daemon. Flag: `--run` |
| `doctor` | Run diagnostic checks on your Remind installation |
| `upgrade` | View available plans or change your current plan |
| `update` | Self-update to the latest version |
| `mcp` | Start the MCP server for Claude Code integration |
| `uninstall` | Remove Remind configuration from your system |

Run `remind <command> --help` for detailed usage on any command.

---

## Claude Code / MCP Integration

Remind ships with a built-in [Model Context Protocol](https://modelcontextprotocol.io/) server, giving Claude Code direct access to your reminders.

### Setup

Add the following to your `.claude/settings.json`:

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

### Available MCP Tools

| Tool | Description |
|------|-------------|
| `add_reminder` | Create a reminder with optional due date, priority, and project |
| `list_reminders` | List active or all reminders |
| `complete_reminder` | Mark a reminder as done |
| `search_reminders` | Search reminders by text |
| `update_reminder` | Modify an existing reminder |
| `delete_reminder` | Permanently remove a reminder |
| `agent_reminder` | Schedule Claude Code to execute a task autonomously at a future time |

---

## Pricing

All plans include the full CLI feature set. Plans differ by the number of AI-powered suggestions per month.

| Plan | Price | AI Suggestions |
|------|-------|----------------|
| Free | $0 | 5 / month |
| Indie | $5 / month | 100 / month |
| Pro | $15 / month | 1,000 / month |
| Team | $50 / month | 5,000 / month |

Register from the terminal:

```bash
remind register
```

---

## Links

- **Website:** [remind.hamzaplojovic.blog](https://remind.hamzaplojovic.blog)
- **Documentation:** [remind.hamzaplojovic.blog/docs](https://remind.hamzaplojovic.blog/docs/)
- **GitHub:** [github.com/hamzaplojovic/remind](https://github.com/hamzaplojovic/remind)
- **Issues:** [github.com/hamzaplojovic/remind/issues](https://github.com/hamzaplojovic/remind/issues)
- **PyPI:** [pypi.org/project/remind-cli](https://pypi.org/project/remind-cli/)

---

## License

MIT

<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=5b1ead4c-c6f5-4caf-a0f8-3d3f2994b5f1" />