Dashboard
The TokenEater window: Monitoring, History, Studio and Settings, in the pills at the top. Open it with Open TokenEater... in the menu bar's right-click menu or the popover.
With Claude and Codex both tracked, the window bar has an All / Claude / Codex switch for Monitoring and History (see Claude and Codex).
Monitoring
The live view. Reorder or hide its blocks in Studio -> Dashboard. In All mode with both providers, Claude and Codex sit in two aligned columns.
- Hero gauge: percentage, Smart Color ring, reset countdown and pacing zone. Right-click it to pick the Glance window: Automatic, Session or Weekly, or the windows of your Codex plan.
- Window tiles: Claude Weekly, Sonnet (with a dedicated Sonnet pool only), Opus, Cowork and Fable when present; the windows your Codex plan declares. A countdown shows when there is a reset time (none for Opus and Cowork).
- Pacing: session and weekly zone and delta. Claude's weekly card hatches off days with workweek pacing and, when you are ahead, counts down to recovery (
back to 0% in 3d 14h). - Extra Credits (Claude only, when the paid pool is on):
x / y this month. - Plan badges: Claude tier and organization; Codex plan, resets available and credits.
Click a tile to flip it: Claude's Weekly, Sonnet and Opus show 7 days from your local Claude Code logs, other tiles their window length and reset date. Click Claude's hero, when it shows Session, to see the session's real trajectory against an even pace.
If a provider has a problem (expired login, rate limit, network error, Codex limit reached), a notice above the blocks explains it, with Copy diagnostic. A header pill flags a Claude outage.
History and Studio
History charts your tokens over time from local logs. Studio holds every visual setting.
Settings
- General: launch at login, launch in background, proxy, refresh interval, Service Status
- Providers: turn each provider on or off, Check connection, Reset connection, Copy diagnostic, coverage matrix
- Pacing: Smart Color, thresholds, pacing margin, workweek
- Watchers: Agent Watchers (Claude only)
- Notifications