Opening "Token usage" (/usage) in the sidebar shows the tokens spent on conversations and what is left on one screen. This is where you judge whether you are close to the limit or need to change plans.
The screen requires a membership. It needs a widget key to load, so in practice it is an admin account screen.
Screen layout
From top to bottom, the screen has three areas.
- Period tabs: where you choose "Daily" or "Monthly" as the period. "Daily" is selected at first
- Tokens left: where you see the balance and usage against the limit
- Balance breakdown: where you see the remaining plan tokens
"as of {date}" at the bottom of the screen is the end point of that period's tally.
Tokens left and usage
The largest number is "Tokens left", shown with "{plan} plan" beside it. The bar below shows usage against the limit as "{used} / {limit} used ({percent}%)".
| Usage | Status text |
|---|---|
| Under 70% | "Plenty left" |
| 70% or more | "Over 70% of the limit" |
| 90% or more | "Close to the limit" |
On a plan with no set limit, "This plan has no limit. Only usage is tracked." is shown instead of the bar.
Plan tokens
The balance breakdown shows "Plan tokens", with the on-screen description "Reset on your next billing date; unused tokens do not roll over." If plan tokens remain close to your billing date, that amount does not roll over.
Without a widget key
If you have not issued a widget key yet, "A widget key is required to read usage. Connect your agent in Connect agent first." is shown instead of usage.
Next steps
- For issuing a widget key, see Persona and casting.
- For token deduction and grant rules, see Tokens and usage.
- For changing plans, see Membership and billing.
- When tokens run out, see Tokens used up.