Verify install

Once TokenEater is running, here's how to confirm everything works - and what to do if you see 0% or empty data.

The good sign

You should see your session usage percentage in the menu bar at the top right. Click it to open the popover with the circular gauges and pacing info.

If you see 0% or no data

Check the following:

• You have an active Claude Pro, Max or Team subscription (Free plans don't expose the usage endpoint)
• Claude Code is installed and you're signed in: claude /login in your terminal
• The credentials file exists: ~/.claude/.credentials.json
• If you're on Claude Code 2.1+: the Keychain helper is installed
• Your internet connection works (the app calls api.anthropic.com)

If session metrics don't show up

You enabled Session reset countdown or Session pacing in settings, the preview shows them, but nothing appears in the actual menu bar. Three likely causes:

• No active session in the past 5 hours: the Anthropic API only returns a 5h bucket if there's an active session. Run claude in your terminal, wait for the next API tick, and the metrics will show up.
• Free plan: the 5h bucket is only exposed to Pro, Max, Team and Enterprise subscriptions. The weekly bucket is exposed to all plans, which is why weekly pacing works while session metrics don't.
• Claude Code 2.1+ without helper: the app can't read a token, all API calls fail silently and stored values stay frozen. Install the helper.