From 3daf72d7208f3cff914f5ebe34cc9ff70a4d3fdc Mon Sep 17 00:00:00 2001 From: Mario Zechner Date: Thu, 5 Mar 2026 20:16:28 +0100 Subject: [PATCH] docs(coding-agent): clarify models.json name behavior (fixes #1840) --- packages/coding-agent/docs/models.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/packages/coding-agent/docs/models.md b/packages/coding-agent/docs/models.md index 20b21871..4c36f38a 100644 --- a/packages/coding-agent/docs/models.md +++ b/packages/coding-agent/docs/models.md @@ -129,7 +129,7 @@ The `apiKey` and `headers` fields support three formats: | Field | Required | Default | Description | |-------|----------|---------|-------------| | `id` | Yes | — | Model identifier (passed to the API) | -| `name` | No | `id` | Display name in model selector | +| `name` | No | `id` | Human-readable model label. Used for matching (`--model` patterns) and shown in model details/status text. | | `api` | No | provider's `api` | Override provider's API for this model | | `reasoning` | No | `false` | Supports extended thinking | | `input` | No | `["text"]` | Input types: `["text"]` or `["text", "image"]` | @@ -137,6 +137,10 @@ The `apiKey` and `headers` fields support three formats: | `maxTokens` | No | `16384` | Maximum output tokens | | `cost` | No | all zeros | `{"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}` (per million tokens) | +Current behavior: +- `/model` and `--list-models` list entries by model `id`. +- The configured `name` is used for model matching and detail/status text. + ## Overriding Built-in Providers Route a built-in provider through a proxy without redefining models: