Configuration

Config file

tutr stores configuration at:

~/.tutr/config.json

Edit directly or use:

tutr-cli configure

Environment overrides

Variable	Description	Default
`TUTR_MODEL`	LLM model in LiteLLM format	`gemini/gemini-3-flash-preview`
`GEMINI_API_KEY`	Gemini API key	none
`ANTHROPIC_API_KEY`	Anthropic API key	none
`OPENAI_API_KEY`	OpenAI API key	none
`XAI_API_KEY`	xAI API key	none
`OLLAMA_HOST`	Ollama host URL override	`http://localhost:11434`
`TUTR_UPDATE_CHECK`	Enable (`1/true`) or disable (`0/false`) update checks	`true`
`NO_COLOR`	Disable ANSI color output when set to any value (follows no-color.org)	unset

You can also toggle update checks in saved config with:

tutr-cli configure --disable-update-check
tutr-cli configure --enable-update-check

Configure command flags

Run tutr-cli configure with no arguments to launch the interactive wizard, or pass any of the flags below for non-interactive use.

Flag	Description
`--interactive`	Run the interactive wizard (default when no other flags are given)
`--provider <name>`	LLM provider (`anthropic`, `gemini`, `ollama`, `openai`, `xai`)
`--model <id>`	Model ID in LiteLLM format (e.g. `openai/gpt-4o`)
`--api-key <key>`	Store a provider API key in config (not recommended — may leak via shell history)
`--clear-api-key`	Remove the stored API key from config
`--ollama-host <url>`	Set Ollama host URL (e.g. `http://localhost:11434`)
`--clear-ollama-host`	Remove the stored Ollama host from config
`--show-explanation`	Enable explanation output by default
`--hide-explanation`	Disable explanation output by default
`--enable-update-check`	Enable periodic update checks (default)
`--disable-update-check`	Disable periodic update checks
`--allow-execute`	In shell mode, allow prompting to auto-run tutr suggestions (default)
`--no-execute`	In shell mode, never prompt to auto-run tutr suggestions

Update checks

tutr periodically checks PyPI for newer versions at most once every 24 hours. When a newer version is found it prints a notice to stderr with a suggested update command (e.g. pipx upgrade tutr or uv tool upgrade tutr). In an interactive terminal it also prompts you to run the update immediately.

The check runs in a background thread with a 1.5-second network timeout, so it never delays a normal query. The last-checked timestamp is cached at ~/.tutr/update-check.json.

To disable update checks permanently:

tutr-cli configure --disable-update-check

To suppress checks for a single session, set the environment variable:

TUTR_UPDATE_CHECK=0

Helpful runtime vars

Variable	Purpose
`TUTR_AUTOSTARTED`	Prevent recursive auto-start in shell rc
`TUTR_SKIP_AUTOSTART`	Temporarily bypass auto-start logic
`TUTR_ACTIVE`	Indicates shell wrapper is active
`TUTR_PROMPT_PREFIX`	Customize wrapper prompt prefix
`TUTR_SHELL`	Override wrapper shell detection (`bash`, `zsh`, `pwsh`, or `powershell`)