talos model

A model is written provider:model, e.g. openai:gpt-5-mini. The MODEL column of talos model list is exactly what talos model use takes.

Operation	What it does
listdefault	Lists the models with context window, tool calling, reasoning and where the data comes from.
use	Sets the model TALOS uses (and so its provider).
effort	Sets the reasoning effort for models that support it, or clears it with default.

Without an operation, talos model runs list.

list

Lists the models with context window, tool calling, reasoning and where the data comes from.

talos model list [--provider <provider>]

Options

--provider <value>

Only the models of one provider.

Exit codes and errors1

Code	Exit	Meaning
PROVIDER_CATALOG_UNAVAILABLE	12	The model provider returned an error. Try again in a moment, or pick another model with /model.

use

Sets the model TALOS uses (and so its provider).

talos model use <provider:model> [--scope user|project|project-user]

Arguments

provider:model

The model id, e.g. openai:gpt-5-mini.

Options

--scope <value> default user

Where to save the choice. Default user. Valuesuserprojectproject-user

Exit codes and errors3

Code	Exit	Meaning
MODEL_REQUIRED	2	The command or the configuration is not valid. Check the command, its options and the configuration.
CONFIG_SCOPE_INVALID	2	The command or the configuration is not valid. Check the command, its options and the configuration.
MODEL_PROVIDER_INVALID	12	The model provider returned an error. Try again in a moment, or pick another model with /model.

effort

Sets the reasoning effort for models that support it, or clears it with default.

talos model effort <effort|default> [--scope user|project-user]

Arguments

effort

The effort, or default to remove the override.

Options

--scope <value> default user

Where to save it. Default user. Not the project scope. Valuesuserproject-user

Exit codes and errors3

Code	Exit	Meaning
REASONING_EFFORT_REQUIRED	2	The command or the configuration is not valid. Check the command, its options and the configuration.
CONFIG_SCOPE_INVALID	2	The command or the configuration is not valid. Check the command, its options and the configuration.
CONFIG_INVALID_REASONING_EFFORT	2	The command or the configuration is not valid. Check the command, its options and the configuration.