Models

Model identifiers use the form providerID/modelID.

Select A Model

• UI: model picker
• TUI: /models
• CLI flag: --model provider/model

Default Model Fields

• model: primary model
• small_model: lightweight helper model for low-cost background tasks

{
  "model": "openai/gpt-5",
  "small_model": "openai/gpt-5-nano"
}

Resolution Order

At runtime, model selection preference is:

1. explicit CLI/UI selection (--model or picker)
2. config model
3. last used session model
4. provider fallback ordering

Per-Model Overrides

provider.<id>.models.<modelID> supports options and variants.

{
  "provider": {
    "<provider-id>": {
      "models": {
        "<model-id>": {
          "options": {
            "timeout": 300000
          },
          "variants": {
            "high": { "disabled": false },
            "max": { "disabled": false }
          }
        }
      }
    }
  }
}

Variant Notes

• Variants are provider/model-specific.
• You can disable unwanted variants with variants.<name>.disabled.
• Agent-level model + variant settings can override global defaults.

Provider/Model Discovery

Use:

• GET /provider
• GET /provider/capability-index
• GET /provider/model-search?q=...

for capability-aware model routing and diagnostics.