Anthropic's AI assistant for writing, analysis, coding and multi-step work, with free and paid plans.
Free stops at: Usage limits apply, Projects: up to 5
Listed Not yet reviewed
Free · paid from $20/mo US · checked Sep 30
Usage tracker
TokenEater
Free macOS menu bar app with widgets that shows Claude and Codex usage limits, pacing and session history.
- Author
- AThevon
- Works with
- Claude Code, OpenAI Codex
- License
- MIT
- Documented
- Oct 28, 2026
What TokenEater is
TokenEater monitors Claude and OpenAI Codex usage limits from the macOS menu bar. It shows live percentages with colour thresholds, a dashboard with history and pacing graphs, native WidgetKit widgets and a floating overlay of running Claude Code sessions. It reads the OAuth token Claude Code keeps in the macOS Keychain and calls Anthropic's read-only usage endpoint; for Codex it reads ~/.codex/auth.json.
What it does
- Menu bar percentages for the five-hour and weekly windows, colour-coded
- Dashboard with sparklines, pacing graphs and 24h to 90d history from local session logs
- Native WidgetKit widgets for Claude and Codex usage
- Agent Watchers overlay that lists live Claude Code sessions and jumps to the terminal
- Multiple Claude accounts, each with its own config folder
- Per-event notifications and custom themes
When to use it
Good fit
- You pay for Claude Pro, Max or Team and want to see the weekly window before it runs out
- You run Claude Code or Codex CLI all day on a Mac
Not for
- Claude's free plan, which exposes no usage data
- Codex API-key accounts
- Windows or Linux
How to install TokenEater
You need: macOS 14 or later; Claude Pro, Max or Team plan, or Codex CLI signed in with ChatGPT
- Download TokenEater.dmg from the GitHub releases page and drag it to Applications
- Or with Homebrew: brew tap AThevon/tokeneater, then brew install --cask tokeneater (brew trust AThevon/tokeneater on Homebrew 6+)
- Sign in to Claude Code once so the OAuth token is in the Keychain
- Launch TokenEater; the menu bar item appears
Permissions and security
What it can access
- Reads the Claude Code OAuth token from the macOS Keychain via the security tool
- Reads ~/.codex/auth.json for Codex
- Calls read-only usage and profile endpoints; the README states it never writes or refreshes tokens
Security notes from the maintainers
- Builds from source are not notarized, so Gatekeeper blocks the first launch
Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.
Limitations
- Depends on undocumented usage endpoints that the vendors can change
Tools it extends
Anthropic's agentic coding tool that reads your codebase, edits files and runs commands from the terminal, IDEs, desktop app or browser.
Watch out: Not included in the Free Claude plan, and usage on subscriptions is capped by plan limits.
Listed Not yet reviewed
Verified code.claude.com (opens Claude Code website in a new tab)
From $20/mo US · checked Sep 29
from $8/mo
OpenAI's coding agent for the CLI, IDE extension, desktop app, web and iOS, included in ChatGPT plans or billed by API.
Free stops at: Desktop app only listed, Usage limits apply
Listed Not yet reviewed
Verified developers.openai.com (opens OpenAI Codex website in a new tab)
Free · paid from $8/mo US · checked Sep 29
Frequently asked questions
Does TokenEater work with the Claude free plan?
No. The README says Claude's free plan does not expose usage data; a Pro, Max or Team plan is required.
How does TokenEater read Claude usage?
It reads the OAuth token Claude Code stores in the macOS Keychain and calls Anthropic's read-only usage and profile endpoints; the README says it never writes to or refreshes credentials.
Does TokenEater support Codex?
Yes, for Codex CLI signed in with ChatGPT: it reads the token from ~/.codex/auth.json. Codex API-key accounts are not supported.
Sources and gaps
- https://github.com/AThevon/TokenEater readme, checked Oct 28, 2026
- https://github.com/AThevon/TokenEater/releases releases, checked Oct 28, 2026