Docs: Cost tracking in CLI (#4043)

This commit is contained in:
Emma Youndtsmith
2025-08-12 12:30:36 -05:00
committed by GitHub
parent b0d3c7ddad
commit 086c4ead03
3 changed files with 17 additions and 8 deletions
@@ -350,7 +350,7 @@ export GOOSE_PLANNER_CONTEXT_LIMIT=1000000
```
## Cost Tracking
Display estimated real-time costs of your session at the bottom of the Goose Desktop window.
Display real-time estimated costs of your session.
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
@@ -360,13 +360,21 @@ To manage live cost tracking:
3. Click the `App` tab
4. Toggle `Cost Tracking` on/off
The session cost updates dynamically as tokens are consumed. Hover over the cost to see a detailed breakdown of token usage. If multiple models are used in the session, this includes a cost breakdown by model. Ollama and local deployments always show a cost of $0.00.
The session cost is shown at the bottom of the Goose window and updates dynamically as tokens are consumed. Hover over the cost to see a detailed breakdown of token usage. If multiple models are used in the session, this includes a cost breakdown by model. Ollama and local deployments always show a cost of $0.00.
Pricing data is regularly fetched from the OpenRouter API and cached locally. The `Advanced settings` tab shows when the data was last updated and allows you to refresh.
These costs are estimates only, and not connected to your actual provider bill. The cost shown is an approximation based on token counts and public pricing data.
</TabItem>
<TabItem value="cli" label="Goose CLI">
Cost tracking is [not yet available](https://github.com/block/goose/issues/3206) in the Goose CLI.
</TabItem>
Show estimated cost in the Goose CLI by setting the `GOOSE_CLI_SHOW_COST` [environment variable](/docs/guides/environment-variables.md#session-management) or including it in the [configuration file](/docs/guides/config-file.md).
```
# Set environment variable
export GOOSE_CLI_SHOW_COST=true
# config.yaml
GOOSE_CLI_SHOW_COST: true
```
</TabItem>
</Tabs>