hoziron-cli models

Browse configured models.

Synopsis

hoziron-cli models <subcommand> [options]

Subcommands

Subcommand	Description
`list`	List available models
`aliases`	Show model shorthand aliases
`set [model]`	Not supported — always fails; see below

There is no hoziron-cli models providers — provider management (list, register, enable, disable) is its own top-level command group. See providers.md.

hoziron-cli models list

hoziron-cli models list [--provider <name>] [--json]

Examples

$ hoziron-cli models list
MODEL                                    PROVIDER        TOOLS
─────────────────────────────────────────────────────────────
claude-sonnet-4-5-20250929               anthropic       yes
claude-3-5-haiku-20241022                anthropic       yes
gpt-4o                                   openai          yes
llama3.1:70b                             ollama          yes

4 model(s)

# Filter by provider
$ hoziron-cli models list --provider ollama
MODEL                                    PROVIDER        TOOLS
─────────────────────────────────────────────────────────────
llama3.1:70b                             ollama          yes

1 model(s)

# No providers configured, or none resolved successfully
$ hoziron-cli models list
No models available. Check provider configuration.

hoziron-cli models aliases

hoziron-cli models aliases [--json]

Model shorthand aliases are not currently implemented — every model is addressed by its full provider/model-id form (or bare model-id where unambiguous). This subcommand exists in the CLI surface but returns an empty/placeholder result today:

$ hoziron-cli models aliases
Model aliases are not yet configured.

$ hoziron-cli models aliases --json
[]

hoziron-cli models set

Not supported — this always fails. The model inventory lives in [[provider]] array entries, each carrying its own [[provider.model]] list (ADR-053). The dotted-path config engine behind hoziron-cli config set can address a scalar key or replace a whole array, but it cannot safely target one element inside a [[provider.model]] array — so this command cannot mutate config.toml in place.

$ hoziron-cli models set "anthropic/claude-sonnet-4-5-20250929"
hoziron-cli models set is no longer supported: the local model is declared in
a [[provider]] entry's [[provider.model]] list (ADR-053), which the config
CLI cannot safely edit in place. Edit ~/.hoziron/config.toml directly — see
docs/reference/config/config-toml.md for the [[provider]] schema.
(exit code 1)

$ hoziron-cli models set
No model specified. Use: hoziron-cli models set <model>
(exit code 1)

Edit ~/.hoziron/config.toml directly instead — see Provider Configuration below.

Provider Configuration

Providers and their models are declared as an explicit [[provider]] inventory in config.toml (ADR-053) — there is no [providers.<name>] table form:

[[provider]]
id = "anthropic"
driver = "anthropic"
api_key_env = "ANTHROPIC_API_KEY"

  [[provider.model]]
  id = "claude-sonnet-4-5-20250929"

[[provider]]
id = "ollama"
driver = "ollama"
url = "http://127.0.0.1:11434/v1"

  [[provider.model]]
  id = "llama3.1:70b"

Key points:

id — an arbitrary, operator-chosen, unique instance identifier (not inferred from driver) — use distinct ids to run two instances of the same driver (e.g. ollama.west / ollama.east)
driver — the concrete provider implementation (anthropic, openai, ollama, etc.), always explicit, never inferred from id
api_key_env — the env var name (not the key itself), resolved lazily at request time
url — override the provider's endpoint (for proxies, local models, custom OpenAI-compatible servers)
[[provider.model]] — one or more models this provider entry serves; referenced by driver/model-id (or id/model-id) elsewhere in config, e.g. in [routing_gateway.*] preference lists