vrr/goose
2
0
Fork 0
mirror of https://github.com/block/goose.git synced 2026-04-28 03:29:36 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 32

docs for reasoning env var (#7367)

Browse source
This commit is contained in:
Emma Youndtsmith 2026-02-19 15:18:26 -06:00 • committed by GitHub
parent 9f8fa368ab
commit 91fad4edcc
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 47 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

39
documentation/docs/getting-started/providers.md
View file

@ -1156,6 +1156,10 @@ Gemini 3 models support configurable thinking levels to balance response latency
- **Low** (default) - Faster responses, lighter reasoning
- **High** - Deeper reasoning, higher latency
:::tip
When thinking is enabled, you can view the model's reasoning process. See [Viewing Model Reasoning](#viewing-model-reasoning) for details.
:::
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
When selecting a Gemini 3 model, a "Thinking Level" dropdown appears automatically. Select your preference and the setting persists across sessions.
@ -1181,6 +1185,41 @@ The thinking level is determined in this order (highest to lowest priority):
3. Default value: `low`
:::
## Viewing Model Reasoning
Some models expose their internal reasoning or "chain of thought" as part of their response. goose automatically captures this reasoning output and makes it available to you. The following models and providers support reasoning output:
| Provider / Model | How It Works |
|---|---|
| **DeepSeek-R1** (via OpenAI, Ollama, OpenRouter, OVHcloud, etc.) | Reasoning captured from the `reasoning_content` field in the API response |
| **Kimi** (via Groq or other OpenAI-compatible endpoints) | Reasoning captured from the `reasoning_content` field in the API response |
| **Gemini CLI** (Google Gemini models with thinking enabled) | Thinking blocks captured from the streaming response |
| **Claude** (Anthropic, with [extended thinking](/docs/guides/environment-variables#claude-extended-thinking) enabled) | Thinking blocks captured from the API response |
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
Reasoning output appears automatically in a collapsible **"Show reasoning"** toggle above the model's response. Click it to expand and view the model's thought process.
</TabItem>
<TabItem value="cli" label="goose CLI">
Reasoning output is **hidden by default** in the CLI. To display it, set the `GOOSE_CLI_SHOW_THINKING` environment variable:
```bash
export GOOSE_CLI_SHOW_THINKING=1
```
When enabled, reasoning appears under a "Thinking:" header in dimmed text before the model's main response.
:::note
This requires stdout to be a terminal (reasoning output won't appear when piping output to a file or another command).
:::
</TabItem>
</Tabs>
:::tip
Reasoning output can be useful for understanding how the model arrived at its answer, debugging unexpected behavior, or learning from the model's problem-solving approach. However, it can also be verbose — toggle it on only when you need it.
:::
---
If you have any questions or need help with a specific provider, feel free to reach out to us on [Discord](https://discord.gg/goose-oss) or on the [goose repo](https://github.com/block/goose).