AThevon/TokenEater

What it solves

TokenEater solves the problem of "blindly" hitting usage limits on Claude AI. Since Anthropic does not provide a native desktop monitor for token consumption, users on Pro, Max, or Team plans often run out of credits without knowing how close they are to their limit or how fast they are consuming them.

How it works

The app reads the OAuth access token from the macOS Keychain (the same token used by Claude Code) to make read-only API calls to Anthropic's usage and profile endpoints. It then processes this data to provide real-time monitoring via a macOS menu bar app, desktop widgets, and a floating overlay. To ensure performance and security, the main app writes usage data to a shared local JSON file, which the WidgetKit extensions read without needing direct network or keychain access.

Who it’s for

Power users of Claude AI (specifically those on Pro, Max, or Team plans) who use Claude Code and want a high-visibility way to track their token usage, pacing, and history on macOS.

Highlights

• Multi-surface monitoring: Track usage via a customizable menu bar popover, native macOS desktop widgets, and a floating overlay.
• Agent Watchers: A floating overlay that monitors active Claude Code sessions and allows users to jump directly to the corresponding terminal.
• Smart Pacing & Coloring: A risk-aware system that calculates a "risk score" based on usage and projection rates, color-coding status into zones like "chill," "on track," "warning," and "hot."
• Usage History: A browser for tokens-over-time based on Claude Code's local JSONL logs, filterable by model family (Opus, Sonnet, Haiku).
• Granular Notifications: Customizable alerts for usage escalation, recovery, pacing, and scheduled reset reminders.