Features

Menu Bar

Your usage at a glance, always visible.

• Live percentages displayed directly in your menu bar - no need to open anything
• Pin any combination of metrics independently: 5h session, 7d weekly, 7d Sonnet, 7d Design, session pacing, weekly pacing, reset countdown
• Three menu-bar styles: Classic (SF system with short labels), Mono (full monospace, tight inline 5h:26 7d:72 format), Badge (each metric in a rounded tinted pill)
• Pacing indicator shape picker: circle, diamond, square, triangle, or star - applied everywhere the pacing glyph renders
• Session reset countdown with three display modes: relative (1h25), absolute (20:30), or both
• Per-bucket pacing style: each pacing metric (session and weekly) can be shown as a coloured dot, a delta (+3%), or both
• Color-coded thresholds: green when comfortable, orange when climbing, red when approaching limits
• Smart reset colour: opt-in mode that tints the reset gauge based on how much headroom you have between your current utilisation and the time left in the window
• Custom menu bar text colours for the reset countdown and session period labels
• Right-click context menu: refresh, quick popover-variant switch, Agent Watchers toggle, settings shortcuts, check for updates, quit
• Left-click to open the detailed popover

Popover

Open the menu bar icon, get a live dashboard. Three layouts, every block reorderable.

• Three layout variants picked from a segmented control:
  • Classic - 2 rings + pacing rows + watchers, the familiar layout.
  • Compact - dense grid of chips + pacing tiles for quick glances.
  • Focus - one hero piece (session reset, weekly reset, session %, or weekly %) with auto-rendered satellites.
• Every block is toggleable and drag-reorderable - promote watchers above pacing, hide the timestamp, put the Open TokenEater button right after the rings, whatever feels right
• Live preview in settings renders the real popover bound to the exact same config you're editing
• Per-variant prefs persisted separately, so you can keep three distinct setups
• Sonnet and Design toggles are independent and work across all three variants
• Plan badge (PRO / MAX / TEAM) toggleable, and refreshed on boot so it shows up instantly

Dashboard

The full cockpit view, dedicated app window.

• Hero command strip: large glowing session percentage, progress track, reset countdown row, and a ring with a zone glyph (leaf / bolt / flame) that reflects your current pacing rhythm
• Metric tiles for Weekly, Sonnet, Design, Opus, and Cowork - each with its own icon, percentage, mini progress bar, and reset countdown
• Pacing signal cards: inline icon + label + zone pill (Chill / On track / Hot), huge glowing delta, runway bar with tricolor zone spectrum, chevron bracket marking the expected position, and a glowing now dot
• Claude Design support: dedicated tile with reset countdown alongside the other metrics
• Extra Credits card when the paid credits pool is enabled, showing used / limit / monthly period
• Tier and Organization as compact footer pills

Agent Watchers

Your Claude Code sessions, live and interactive.

• 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
• Tunable hover zone: pick Minimal (18 px), Narrow (40 px), Medium (80 px, default), or Wide (130 px, previous behaviour) so the overlay doesn't steal clicks from apps behind it
• Display mode: choose between "Branch priority" (branch as title when not on main) or "Project + Branch" (project name always visible, branch next to status)

Widgets

Three WidgetKit widgets for your desktop - information without opening anything.

• 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

Themes

Make it yours.

• 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.

• 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

Keychain helper (Claude Code 2.1+)

An opt-in bridge for users whose Claude Code no longer writes ~/.claude/.credentials.json.

• Non-sandboxed LaunchAgent that reads the OAuth token from the macOS Keychain via the official /usr/bin/security and writes it to a file TokenEater can load
• Configurable sync interval (30s minimum, default 5min) in Settings → Agent Watchers → Keychain helper
• Force sync now button to refresh the token on demand, e.g. right after claude /login
• Fully optional if you still have Claude Desktop or an older Claude Code that writes the credentials file

Secure auto-updates

Every update is verified end to end, with release notes right in the modal.

• Sparkle auto-updates verify the EdDSA (Ed25519) signature of the downloaded DMG against the embedded public key before running the installer
• Updates with missing or invalid signatures are refused with a clear error instead of installing blindly
• The signing key lives only in CI secrets, so every release DMG is signed by the same identity
• Release notes in the update modal: the "What's new" section fetches and renders the notes directly from the GitHub Releases API, with a View on GitHub fallback link if the fetch fails

SOCKS5 Proxy

For corporate environments behind a proxy.

• Configure proxy host, port, and optional authentication
• All API calls route through the proxy transparently