Features
Menu Bar
Your usage at a glance, always visible.
5h42%·7d68%·+12%
- Live percentages displayed directly in your menu bar — no need to open anything
- Pin individual metrics: session (5h window), weekly (all models), weekly (Sonnet), pacing
- Color-coded thresholds: green when comfortable, orange when climbing, red when approaching limits
- Click to open the detailed dashboard popover
Right-click the menu bar icon to quickly toggle which metric is displayed.
Dashboard
The full picture in one popover.
42%
68%
23%
- Ring gauges showing session and weekly usage with animated progress and glow
- Pacing system with three zones: chill (green), on track (blue), hot (red)
- Countdown timer showing when your session limit resets
- Quick actions and detailed breakdowns per model (Opus, Sonnet, Haiku)
Agent Watchers
Your Claude Code sessions, live and interactive.
Thinking
Executing
- Real-time monitoring of every active Claude Code session
- See each session's state: idle, thinking, executing, waiting, subagent, compacting
- Click any session to teleport to its terminal window
- Works with virtually any terminal or IDE: iTerm2, WezTerm, Terminal.app, Warp, Ghostty, VS Code, Cursor, Windsurf, Zed, tmux, and more
- Floating overlay that hugs your screen edge (left or right)
- Dock-like proximity effect: capsules expand on hover with smooth spring animations
Agent Watchers require Claude Code to be running in your terminal. The watcher detects sessions automatically — no configuration needed.
Widgets
Three WidgetKit widgets for your desktop — information without opening anything.
5h
7d
Son
- Medium — Usage: Ring gauges for session, weekly, and pacing at a glance
- Large — Usage: Full progress bars with detailed numbers and model breakdown
- Small — Pacing: Circular gauge with ideal usage marker and zone indicator
After updating TokenEater, remove your existing widget and add a new one. macOS caches widget data aggressively and may show stale information until you do.
Themes
Make it yours.
65%
Default
65%
Neon
65%
Pastel
65%
Mono
- 4 built-in presets: Default, Monochrome, Neon, Pastel
- Full custom theme support with color pickers for every element
- Adjustable warning (default 60%) and critical (default 85%) thresholds
- Theme applies everywhere: menu bar, dashboard, and widgets
Notifications
Never be caught off guard.
⚠Usage at 60%
●Approaching limit
- Warning notification when usage crosses the warning threshold
- Critical notification when approaching the limit
- Reset notification when your session window resets
- Test notifications from Settings to verify they work
SOCKS5 Proxy
For corporate environments behind a proxy.
- Configure proxy host, port, and optional authentication
- All API calls route through the proxy transparently