docs: add CLI token usage (#2857)

Co-authored-by: Rizel Scarlett <rizel@squareup.com>
This commit is contained in:
dianed-square
2025-06-11 07:19:33 -07:00
committed by GitHub
parent 2050fc1846
commit ff0c530a70

View File

@@ -141,22 +141,30 @@ Key information has been preserved while reducing context length.
</Tabs> </Tabs>
### Token usage ### Token usage
After sending your first message, Goose Desktop and Goose CLI display token usage.
<Tabs> <Tabs>
<TabItem value="ui" label="Goose Desktop" default> <TabItem value="ui" label="Goose Desktop" default>
After sending your first message to Goose, a colored circle appears 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. 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 - **Green**: Normal usage - Plenty of context space available
- **Orange**: Warning state - Approaching limit (80% of capacity) - **Orange**: Warning state - Approaching limit (80% of capacity)
- **Red**: Error state - Context limit reached - **Red**: Error state - Context limit reached
Hover over this circle to display: Hover over this circle to display:
- the number of tokens used - The number of tokens used
- the percentage of available tokens used - The percentage of available tokens used
- the total available tokens - The total available tokens
- A progress bar showing your current token usage - A progress bar showing your current token usage
</TabItem> </TabItem>
<TabItem value="cli" label="Goose CLI"> <TabItem value="cli" label="Goose CLI">
This functionality is not available in the Goose CLI. The CLI displays a context label above each command prompt, showing:
- A visual indicator using dots (●○) and colors to represent your token usage:
- **Green**: Below 50% usage
- **Yellow**: Between 50-85% usage
- **Red**: Above 85% usage
- Usage percentage
- Current token count and context limit
</TabItem> </TabItem>
</Tabs> </Tabs>