Configuration

Remind stores configuration in a JSON file at ~/.remind/config.json. All settings can be modified via the CLI or by editing the file directly.

Config file location

The config file is automatically created on first run:

Platform	Path
macOS	`~/.remind/config.json`
Linux	`~/.remind/config.json`
Windows	`%USERPROFILE%\.remind\config.json`

View the path on your system:

$ remind settings
  CONFIG             ~/.remind/config.json

Settings reference

Key	Type	Default	Description
`timezone`	string	`"UTC"`	IANA timezone for due date display
`scheduler_interval_minutes`	int	`1`	How often the scheduler checks for due reminders (1-60)
`notifications_enabled`	bool	`true`	Enable/disable OS notifications
`notification_sound_enabled`	bool	`true`	Play sound with notifications
`ai_rephrasing_enabled`	bool	`true`	Use AI to enhance reminder text
`ai_backend_url`	string \| null	`null`	Custom backend API URL for AI suggestions
`openai_api_key`	string \| null	`null`	OpenAI API key for local AI usage
`nudge_intervals_minutes`	list[int]	`[5, 15, 60]`	Minutes after due time to send follow-up nudges

Modifying settings

Via CLI

# Set a value
$ remind settings --set timezone=America/New_York
  ✓ Set timezone = America/New_York

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

# View all settings
$ remind settings --view

Via file

Edit ~/.remind/config.json directly:

{
  "timezone": "America/New_York",
  "scheduler_interval_minutes": 5,
  "notifications_enabled": true,
  "notification_sound_enabled": true,
  "ai_rephrasing_enabled": true,
  "nudge_intervals_minutes": [5, 15, 60]
}

Database

Reminders are stored in a local SQLite database:

Platform	Path
macOS / Linux	`~/.remind/remind.db`
Windows	`%USERPROFILE%\.remind\remind.db`

Tip

The database is a standard SQLite file. You can query it directly with sqlite3 ~/.remind/remind.db for advanced use cases like bulk exports.

Environment variables

These override config file values when set:

Variable	Overrides
`REMIND_OPENAI_API_KEY`	`openai_api_key`
`REMIND_BACKEND_URL`	`ai_backend_url`
`REMIND_TIMEZONE`	`timezone`

Commands

AI Features