Skip to content

Docs: Cost tracking on the desktop app #3204

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dianed-square merged 7 commits into from
Jul 1, 2025
+24 −3
Merged

Docs: Cost tracking on the desktop app #3204

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
b7dc36c
Docs: Cost tracking on the desktop app
emma-squared Jul 1, 2025
b731eac
Add desktop and CLI tabs
emma-squared Jul 1, 2025
eb729bd
Move token usage and cost tracking sections higher in TOC
emma-squared Jul 1, 2025
320d4ab
Update documentation/docs/guides/smart-context-management.md
emma-squared Jul 1, 2025
5d3d0e3
Update documentation/docs/guides/smart-context-management.md
dianed-square Jul 1, 2025
83607a4
add groupId param and demote h3
dianed-square Jul 1, 2025
0ad91fc
Update documentation/docs/guides/smart-context-management.md
dianed-square Jul 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 24 additions & 3 deletions documentation/docs/guides/smart-context-management.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ You can proactively summarize your conversation before reaching context limits:

The CLI offers three context management options: summarize, truncate, or clear your session.

### Default Context Strategy
#### Default Context Strategy

You can configure Goose to automatically handle context limits without prompting by setting the `GOOSE_CONTEXT_STRATEGY` environment variable:

Expand Down Expand Up @@ -135,10 +135,10 @@ Key information has been preserved while reducing context length.
</TabItem>
</Tabs>

### Token usage
## Token Usage
After sending your first message, Goose Desktop and Goose CLI display token usage.

<Tabs>
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
The Desktop displays a colored circle next to the model name at the bottom of the session window. The color provides a visual indicator of your token usage for the session.
- **Green**: Normal usage - Plenty of context space available
Expand All @@ -163,3 +163,24 @@ After sending your first message, Goose Desktop and Goose CLI display token usag

</TabItem>
</Tabs>

## Cost Tracking
Display real-time costs of your session at the bottom of the Goose Desktop window.

<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
To manage live cost tracking:
1. Click `⚙️` in the upper right corner
2. Click `Advanced Settings`
3. Scroll to `App Settings` and toggle `Cost Tracking` on or 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.

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>
</Tabs>
Loading