The Archive · CLI reference

Environment variables

The environment variables TALOS CLI reads, and what each one changes.

Reference for TALOS CLI 0.3.3 generated from the npm package · released

TALOS CLI 0.5.2 is out; this page still describes 0.3.3 and updates with the next build.

TALOS_CREDENTIAL_STORE
Where keys are kept for this process: system or memory. Overrides credentials.store.Valuessystemmemory
TALOS_MODELS_DEV
Set to off to turn off the models.dev catalog: nothing is sent.Valuesoff
TALOS_REDUCED_MOTION
Set to 1 or true to reduce animation in the interactive screen.Values1true
TALOS_RG_PATH
Path of the ripgrep binary to use for search, instead of the one shipped with the package.
TALOS_TRACE_ID
A trace id to reuse in failure reports (1 to 128 printable characters), e.g. from a parent process.
TALOS_CLI_UPDATE_CHANNEL
The default channel of talos update.Valuesstablepreview
NO_COLOR
Any value turns colors off, as --no-color does.
VISUAL
The editor used to compose a long prompt (checked before EDITOR).
EDITOR
The editor used to compose a long prompt, when VISUAL is not set.
APPDATA
Windows: the settings folder is %APPDATA%\TALOS-CLI.
LOCALAPPDATA
Windows: data, sessions and logs are under %LOCALAPPDATA%\TALOS-CLI.
XDG_CONFIG_HOME
macOS and Linux: if set, the settings folder; otherwise ~/.config/talos-cli.
XDG_STATE_HOME
macOS and Linux: if set, the data folder; otherwise ~/.local/state/talos-cli.
XDG_CACHE_HOME
macOS and Linux: if set, the cache folder; otherwise ~/.cache/talos-cli.

Each provider can take its key from the variables listed on Providers. A key found in the environment is not used until you approve it — talos provider env-key <provider> --use, or when the interactive screen asks. One-shot commands that run a model (talos research start, talos automation run) use it and say where the key came from.

TALOS reads these only to recognize the terminal (colors, notifications, remote sessions):

TERMTERM_PROGRAMWT_SESSIONTMUXSTYKITTY_WINDOW_IDSSH_CLIENTSSH_CONNECTIONSSH_TTY

Type to search the guides.