aljaz/goose
1
0
Fork 0
mirror of https://github.com/aljazceru/goose.git synced 2025-12-17 22:24:21 +01:00
Code Issues Packages Projects Releases Wiki Activity

Docs: Cost tracking on the desktop app (#3204)

Browse Source 
Co-authored-by: Angie Jones <jones.angie@gmail.com>
Co-authored-by: dianed-square <73617011+dianed-square@users.noreply.github.com>
Co-authored-by: Diane Diaz <dianed@squareup.com>
This commit is contained in:
Emma Youndtsmith
2025-07-01 18:53:40 -05:00
committed by GitHub
parent 2948d4a375
commit ee43041640
1 changed files with 24 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
documentation/docs/guides/smart-context-management.md
View File

@@ -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:
@@ -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
@@ -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>