AI Features

Remind uses AI to transform rough input into well-structured reminders with optimal timing and priority. Here's how it works and how to control it.

How it works

When you run remind add, the AI processes your text in three ways:

Text refinement — Cleans up grammar, capitalization, and phrasing while preserving your intent
Time suggestion — Infers optimal due time from context ("tomorrow" becomes a specific datetime)
Priority assignment — Assigns high/medium/low based on urgency signals in the text

Example flow

$ remind add "call mom tmrw"

  Input     → "call mom tmrw"
  Refined   → "Call mom tomorrow at 3:00 PM"
  Due       → Tomorrow, 3:00 PM
  Priority  → High

  AI  Call mom tomorrow at 3:00 PM
  ✓ Reminder saved (#4)

The AI suggestion is shown before saving. The original text is preserved in the database alongside the AI-enhanced version.

Quotas by plan

AI suggestions consume quota based on your plan tier:

Plan	AI Suggestions / Month	Price
Free	5	$0
Indie	100	$5/mo
Pro	1,000	$15/mo
Team	5,000+	$50/mo

Check your remaining quota:

$ remind report
  AI SUGGESTIONS USED  12
  PLAN                 Indie — 100 AI suggestions/month

Tip

When quota runs out, reminders are still created — they just skip the AI step. You'll see a warning in the output.

Disabling AI

Per-command

Skip AI for a single reminder with --no-ai:

$ remind add "exact text I want" --no-ai

Globally

Disable AI for all reminders:

$ remind settings --set ai_rephrasing_enabled=false

Re-enable anytime:

$ remind settings --set ai_rephrasing_enabled=true

Using your own API key

By default, AI requests go through the Remind backend API. You can use your own OpenAI key for direct access:

# Via settings
$ remind settings --set openai_api_key=sk-...

# Or via environment variable
$ export REMIND_OPENAI_API_KEY=sk-...

Important

When using your own key, AI suggestions are billed directly to your OpenAI account and do not count against your Remind plan quota.

Custom backend

Point Remind at a self-hosted or custom AI backend:

$ remind settings --set ai_backend_url=https://your-api.example.com

The backend must implement the POST /api/v1/suggest-reminder endpoint. See the backend source for the API contract.

Privacy

Reminder text is sent to the AI backend only when AI is enabled
Reminder text is never stored on remote servers beyond request processing
Use --no-ai for sensitive reminders
Self-host the backend for full data control

Configuration

Troubleshooting