TokenEater

Monitor your Claude AI usage limits directly from your macOS desktop.

Website · Docs · Download

---

**Requires a Claude Pro, Max, or Team plan.** The free plan does not expose usage data.

What is TokenEater?

A native macOS menu bar app + desktop widgets + floating overlay that tracks your Claude AI usage in real-time.

• Menu bar — Live percentages, color-coded thresholds, detailed popover dashboard
• Widgets — Native WidgetKit widgets (usage gauges, progress bars, pacing) with reactive refresh
• Agent Watchers — Floating overlay showing active Claude Code sessions with dock-like hover effect. Click to jump to the right terminal (Terminal.app, iTerm2, tmux, Kitty, WezTerm).
• Smart pacing — Are you burning through tokens or cruising? Three zones: chill, on track, hot.
• Themes — 4 presets + full custom colors. Configurable warning/critical thresholds.
• Notifications — Alerts at warning, critical, and reset.

See all features in detail on the [website](https://tokeneater.vercel.app).

Install

Download DMG (recommended)

**[Download TokenEater.dmg](https://github.com/AThevon/TokenEater/releases/latest/download/TokenEater.dmg)**

Open the DMG, drag TokenEater to Applications, then:

1. Double-click TokenEater in Applications — macOS will block it
2. Open System Settings → Privacy & Security — scroll down to find the message about TokenEater
3. Click Open Anyway and confirm

**Important:** Do not use `xattr -cr` to bypass this step — it prevents macOS from approving the widget extension, which will then be flagged as malware in the widget gallery.

Homebrew

brew tap AThevon/tokeneater
brew install --cask tokeneater

First Setup

...