KrustyPlanet/hermes-agent
6
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

docs: session-scoped /model and /reasoning defaults

Browse source
This commit is contained in:
Teknium 2026-07-20 01:29:40 -07:00
parent dc0dbc9387
commit 76fca0b4b3
2 changed files with 11 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

4
website/docs/reference/cli-commands.md
View file

@ -199,7 +199,7 @@ Switch between already-configured models without leaving a session:
/model openrouter:anthropic/claude-sonnet-4 # Switch back to cloud
```
By default, `/model` changes apply **to the current session only**. Add `--global` to persist the change to `config.yaml`:
By default, `/model` changes apply **to the current session only**. Add `--global` to persist the change to `config.yaml` (or set `model.persist_switch_by_default: true` to make every switch persist):
```
/model claude-sonnet-4 --global # Switch and save as new default
@ -209,7 +209,7 @@ By default, `/model` changes apply **to the current session only**. Add `--globa
If you've only configured OpenRouter, `/model` will only show OpenRouter models. To add another provider (Anthropic, DeepSeek, Copilot, etc.), exit your session and run `hermes model` from the terminal.
:::
Provider and base URL changes are persisted to `config.yaml` automatically. When switching away from a custom endpoint, the stale base URL is cleared to prevent it leaking into other providers.
On a `--global` switch, provider and base URL changes are persisted to `config.yaml` alongside the model. When switching away from a custom endpoint, the stale base URL is cleared to prevent it leaking into other providers.
## `hermes gateway`

14
website/docs/user-guide/configuration.md
View file

@ -1323,13 +1323,17 @@ native Anthropic provider already controls effort directly and is unaffected.
You can also change the reasoning effort at runtime with the `/reasoning` command:
```
/reasoning # Show current effort level and display state
/reasoning high # Set reasoning effort to high
/reasoning none # Disable reasoning
/reasoning show # Show model thinking above each response
/reasoning hide # Hide model thinking
/reasoning # Show current effort level and display state
/reasoning high # Set reasoning effort to high (this session only)
/reasoning high --global # Set effort and persist to config.yaml
/reasoning none # Disable reasoning (this session only)
/reasoning show # Show model thinking above each response
/reasoning hide # Hide model thinking
```
Effort changes are session-scoped by default; add `--global` to save the
new level as your `agent.reasoning_effort` default.
#### Per-Model Reasoning Overrides
You can set different reasoning effort levels for different models. This is useful when you want high reasoning for complex models but medium for faster ones: