From ee43041640d2590422de6dd0fe86290eb718169f Mon Sep 17 00:00:00 2001 From: Emma Youndtsmith <90283317+emma-squared@users.noreply.github.com> Date: Tue, 1 Jul 2025 18:53:40 -0500 Subject: [PATCH] Docs: Cost tracking on the desktop app (#3204) Co-authored-by: Angie Jones Co-authored-by: dianed-square <73617011+dianed-square@users.noreply.github.com> Co-authored-by: Diane Diaz --- .../docs/guides/smart-context-management.md | 27 ++++++++++++++++--- 1 file changed, 24 insertions(+), 3 deletions(-) diff --git a/documentation/docs/guides/smart-context-management.md b/documentation/docs/guides/smart-context-management.md index 06d9c493..abd80b17 100644 --- a/documentation/docs/guides/smart-context-management.md +++ b/documentation/docs/guides/smart-context-management.md @@ -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. -### Token usage +## Token Usage After sending your first message, Goose Desktop and Goose CLI display token usage. - + 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 + +## Cost Tracking +Display real-time costs of your session at the bottom of the Goose Desktop window. + + + +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. + + + Cost tracking is [not yet available](https://github.com/block/goose/issues/3206) in the Goose CLI. + + \ No newline at end of file