Installation

TokenEater is a native macOS app distributed as a DMG or via Homebrew. A few minutes is all it takes to go from zero to a live usage percentage in your menu bar.

Requirements

  • macOS 14 (Sonoma) or later
  • A Claude Pro, Max or Team subscription - Free plans don't expose the usage API
  • Claude Code installed: TokenEater reads your credentials automatically, no manual config
TokenEater detects your OAuth token in this order: ~/.claude/.credentials.json, then Claude Desktop config, then the Keychain helper (Claude Code 2.1+). The app will offer to install the helper if it finds nothing.

Download the DMG

Download TokenEater.dmg

Open the DMG, drag TokenEater into Applications, then:

  1. 1

    Double-click TokenEater in Applications. macOS will block it on first launch.

  2. 2

    Open System Settings -> Privacy & Security, scroll down to the message about TokenEater.

  3. 3

    Click Open Anyway and confirm.

Don't use xattr -cr to bypass Gatekeeper. It prevents macOS from approving the widget extension, which will be flagged as malware. Always go through System Settings -> Open Anyway.

Homebrew

One command to install the cask:

bash
brew tap AThevon/tokeneater
brew install --cask tokeneater

To upgrade later: brew upgrade --cask tokeneater.