docs(kilo-docs): document per-agent model memory and reset button

Add missing behavior to model-selection.md VSCode tab: 'last picked per
agent' level in precedence chain, and a note that the model selector
remembers picks across sessions with reset button to restore config.

Add the same note to custom-modes.md for both the VSCode and CLI tabs
under the model property reference (previously only documented in the
VSCode Legacy tab as 'Sticky Models').
This commit is contained in:
kirillk
2026-04-20 09:20:10 -04:00
parent 1cc026ac30
commit e0599bce00
2 changed files with 6 additions and 1 deletions
@@ -26,7 +26,8 @@ While the specifics change constantly, some principles stay consistent:
- Use the **model selector** in the chat prompt area to pick a model for the current session. You can also type `/models` to open the model picker.
- Set per-agent defaults and a global default in the **Settings** panel (Models tab), or directly in the `kilo.jsonc` config file.
- **Model precedence:** Session override → Per-agent config → Global config → Recent models → Kilo Auto (free).
- **Model precedence:** Session override → Last picked per agent → Per-agent config → Global config → Kilo Auto (free).
- The model selector remembers the last model you picked for each agent — switching agents restores your previous choice. A manual pick always beats config settings; use the **reset button** (visible when your active model differs from config) to go back to the config default.
{% /tab %}
{% tab label="CLI" %}
@@ -161,6 +161,8 @@ Pin a specific model using the `provider/model` format:
model: anthropic/claude-sonnet-4-20250514
```
The model selector also **remembers the last model you picked for each agent** across sessions. A config-pinned `model` acts as the default when no manual pick exists. To reset a pick and let the config take over, use the **reset button** in the model selector (visible when your active model differs from what the config specifies).
### `steps`
Limits the number of agentic iterations (tool call rounds) before the agent is forced to respond with text only. Useful for preventing runaway agents:
@@ -379,6 +381,8 @@ Pin a specific model using the `provider/model` format:
model: anthropic/claude-sonnet-4-20250514
```
The TUI also **remembers the last model you picked for each agent** across sessions. A config-pinned `model` acts as the default when no manual pick exists. To reset a pick and let the config take over, use the model picker (`Ctrl+X m`) and select a different model, or remove the saved pick from `~/.local/state/kilo/model.json`.
### `steps`
Limits the number of agentic iterations (tool call rounds) before the agent is forced to respond with text only. Useful for preventing runaway agents: