Installation

Install TokenEater from the DMG or Homebrew, then follow the setup window.

Requirements

  • macOS 14 (Sonoma) or later
  • At least one provider signed in on this Mac:
    • Claude: Claude Code on a Pro, Max or Team plan (claude, then /login)
    • Codex: the Codex CLI signed in with ChatGPT (codex login)

TokenEater reads the logins already on your Mac. See Claude and Codex.

Download the DMG

Download TokenEater.dmg

  1. 1

    Open the DMG and drag TokenEater into Applications. Keep it there: in-app updates only run from /Applications.

  2. 2

    Launch it: the DMG is notarized, so no Gatekeeper prompt. Then see First launch.

Homebrew

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

Homebrew 6.0+ needs brew trust before it loads a third-party tap. To upgrade: brew update && brew upgrade --cask tokeneater, or use the in-app updater.

Build it yourself

bash
git clone https://github.com/AThevon/TokenEater.git
cd TokenEater
./build.sh

Needs Xcode. The script installs XcodeGen if needed and prints the command to copy the app into /Applications. Local builds are not notarized: on first launch, right-click the app then Open, or use System Settings -> Privacy & Security -> Open Anyway. More in Signing & notarization.