First launch

What happens the first time you open TokenEater, and how to clear the onboarding wizard in two minutes.

Launch the app

  1. 1

    Open TokenEater from Applications.

  2. 2

    Grant Keychain access when prompted. This is what lets the app read your Claude Code credentials.

  3. 3

    The app lives in the menu bar at the top right. Look for the usage percentage.

  4. 4

    Click the icon to open the detailed popover with gauges and pacing.

The onboarding wizard

On first launch, TokenEater shows a hero onboarding with a 2x2 grid. Each card is interactive and uses the real production components - so the preview is the actual app, not a mockup.

Required steps

  • Claude Code: terminal verification step, the app confirms it can read your credentials
  • Notifications: permission authorization, with off / authorized / denied states

Optional steps

  • Watchers: toggle the agent overlay, with a real preview that reacts to display mode changes
  • Connect: confirms TokenEater can read your OAuth token, with idle / connecting / success / failed states
The window is drag-from-anywhere, so you can move it by clicking on any content, not just the title bar.

Add a widget

To get TokenEater on your desktop or in Notification Center:

  1. 1

    Right-click on the desktop -> Edit Widgets.

  2. 2

    Look for TokenEater in the list.

  3. 3

    Drag the widget of your choice (small, medium, large) onto the desktop.

After every TokenEater update, remove and re-add your widgets. macOS aggressively caches widget binaries, and may show stale data otherwise.