TokenGauge
EspañolDownload

Your AI coding quota, one glance away.

See how much Claude Code or Codex quota you have left, when it resets and whether it will last, right from your Mac's menu bar.

Download for MacView on GitHub
  • Free and MIT licensed
  • macOS 14+
  • Apple Silicon
  • v1.7.1

Your number, next to the clock.

Pick how the indicator looks. Right-click it in the menu bar to change it instantly.

Try it. This is the panel.

Switch agents, flip to Stats and fold the cards you do not need. Same labels and layout as the app, with sample data.

Sample data

TokenGauge
Codex1 min. ago
General weekly66% left

Resets in 5d

≈ 1.3 pp/h

Claude1 min. ago[email protected]
5h session62% left

Resets in 2h · 2:00 PM

Cutting it close · 18%/h

Weekly39% left

Resets in 2d

≈ 1.0 pp/h

Fable weekly58% left

Resets in 2d

≈ 0.7 pp/h

202633 d
Saturday, Sep 26TodayModel and effort
57.8M238.6M

Will it last until the reset?

Stats projects your pace to the reset for every weekly and 5-hour limit, then tells you what will be left or exactly when it runs out.

Won't last

Runs out Wed 2:05 PM, 18 h before the reset.

General weeklyResets in 5d
100%50%0%ResetNow · 66%TFSSMTWT
  • 3 d: 16%/day
  • 24 h: 17%/day
  • Max 14%/day
Cutting it close

You'll make it, with only ~8% left.

WeeklyResets in 2d
100%50%0%ResetNow · 39%TWTFSSM
  • 3 d: 13%/day
  • 24 h: 13%/day
  • Max 16%/day
Cutting it close

You'll make it, with only ~9% left.

5h sessionResets in 2h · 2:00 PM
100%50%0%ResetNow · 62%10 AM11 AM12 PM1 PM
  • Session: 18%/h
  • 1 h: 18%/h
  • Max 21%/h
You'll make it

At this pace you reach the reset with ~37% left.

Fable weeklyResets in 2d
100%50%0%ResetNow · 58%TWTFSSM
  • 3 d: 9%/day
  • 24 h: 9%/day
  • Max 24%/day

Real app. Not sped up.

Recorded on a MacBook with demo data: open the panel, flip to Stats, check whether the week lasts, then switch to Unified.

Demo data · not sped up

Reads little. Keeps it local.

No TokenGauge server, no analytics, no telemetry, no ads and no model requests.

  • Your Claude Code sign-in

    Reads the existing Claude Code credential from the macOS Keychain and keeps it in memory only. It never writes, creates or renews it.

  • Two destinations, nothing else

    The only request TokenGauge makes itself is Anthropic's usage endpoint, with that same token. Update checks go to GitHub through Sparkle.

  • Codex stays local

    Codex numbers come from your own local codex app-server. TokenGauge makes no HTTP call for Codex.

  • Counters, not conversations

    Reads local session logs for timestamps, model, reasoning effort and token counts. Prompt and response content is never read or stored.

  • One private folder

    History lives in Application Support with user-only access. Nothing is uploaded.

Status line, if you want it.

Run the opt-in installer to add a capture fallback to your status-line script; it backs up first and expects the app in ~/Applications.

The real panel, up close.

Captured on a Mac running TokenGauge 1.7 with synthetic demo data.

Unified view with the Codex general weekly quota and Claude's 5-hour session, weekly and Fable weekly quotas above the yearly activity calendar
Stats view answering whether the Claude weekly quota lasts until the reset, with the chart, pace and a row for each limit
Stats view with the best day, streak, the last 14 days by model, activity and the models used this week
Rings panel style with the Claude 5-hour session, weekly and Fable weekly quotas as rings
Settings with a live menu bar preview, limit chips, indicator styles and panel, general and account options

Questions, answered.

Is TokenGauge free?

Yes. TokenGauge is free and open source under the MIT license. No account, subscription or API key.

Which Macs does it support?

Apple Silicon Macs running macOS 14 or later. Intel builds are not currently distributed.

Do I need both Claude Code and Codex?

No. Install and sign in to the one you use, then pick it in TokenGauge. Without a signed-in provider it shows a sign-in state and never invents a balance.

What does it send over the network?

Only two things leave your Mac because of TokenGauge: the usage request to Anthropic's own endpoint, using your existing Claude Code token, and Sparkle update checks to GitHub. Codex data comes from your local codex app-server.

Why might macOS ask about the Keychain?

Claude quota needs the credential Claude Code already saved. Depending on that item's access policy, macOS may ask before TokenGauge reads it. It is kept in memory and never written back.

Are token totals the same as quota?

No. Quota percentages come from the provider. Token history is locally observed activity and is not used to calculate your remaining quota.

How do updates work?

With automatic checks on, TokenGauge looks for signed Sparkle updates on GitHub in the background. When one is ready a banner offers Install now or Later. You can turn checks off in Settings.

Is it affiliated with Anthropic or OpenAI?

No. TokenGauge is independently developed. Provider names and marks belong to their owners.

TokenGauge

Stop guessing. Glance.

Free for every Apple Silicon Mac. Install it, pick your agent and the menu bar does the rest.

Download TokenGauge

Version 1.7.1 · Release notes

macOS 14 or later · Apple Silicon · MIT license