AI Quota Usage Meter

Help

Support

Email support@mannbadal.com and you will get a reply from the person who wrote the app.

Connecting Claude

Choose Sign in with Claude. On iPhone, Anthropic's sign-in page opens inside AI Quota; on Mac it opens in your default browser. AI Quota listens only on your device's loopback interface at the fixed port localhost:54545, verifies the returned sign-in state, exchanges the code, and closes the listener. The app's code then calls only Claude's usage endpoint.

If port 54545 is already busy or the callback times out, AI Quota automatically switches to Paste authorization code and opens Claude's console authorization page. Paste the full callback URL, Claude's code#state result, or the bare code. The state is checked whenever one is included. Anthropic requires Claude Code's complete registered scope set for this public client; AI Quota does not describe that token as profile-only.

If you already use Claude Code on a Mac, the Claude Code credentials option reuses its existing sign-in: run the command AI Quota shows you in Terminal and paste the result. A sandboxed App Store app cannot read another app's Keychain items directly, which is why this is a copy and paste rather than an automatic import.

Connecting Codex

Choose Sign in with ChatGPT and AI Quota opens the real ChatGPT sign-in page, on whichever device you are holding. It renews the session itself from then on, so this is a one-time step.

The alternative is to paste the contents of ~/.codex/auth.json, the file the Codex CLI writes when you sign in. That works too, and AI Quota keeps it renewed rather than asking you for the file again.

Codex limits exist only for ChatGPT plan sign-ins. If your auth.json contains an API key instead, there is no plan allowance to meter and AI Quota will tell you so rather than showing an empty gauge.

Connecting GitHub Copilot

Create a classic personal access token on GitHub and leave every scope unchecked. Reading your own Copilot quota needs no scope at all, so there is no reason to hand over more.

Fine-grained tokens do not work here — a GitHub restriction, not an AI Quota one. If a token is rejected, check that it is the classic kind before anything else. AI Quota reads the same allowances your editor shows: premium requests on a paid plan, chat and completions on the free one.

A meter has stopped updating

AI Quota shows the last figure it managed to retrieve, with its age underneath, so a stale meter looks stale rather than wrong. Common causes:

  • Rate limiting. Anthropic in particular limits how often usage can be checked. AI Quota deliberately spaces its requests out and backs off further after a refusal, so a meter can legitimately be up to an hour old. Forcing repeated refreshes makes this worse, not better.
  • An expired sign-in. The account shows a Reconnect badge. Reconnecting takes a few seconds and keeps your history.
  • A service changed its interface. Only GitHub publishes a documented usage endpoint; the others can change without notice. If a meter stays stale after reconnecting, please email — knowing which service and roughly when it stopped is genuinely useful.

Widgets are not refreshing

Widgets redraw on a schedule the system controls. When their data is more than two hours old, one widget may request a rescue refresh; iOS background refresh and the resident Mac app also keep shared data warm. Every path goes through the same safety floor and provider-wide backoff. Pressing Refresh, pulling to refresh on iPhone, or requesting a refresh from the Watch uses that budget too. If a widget looks stuck, check that the app itself shows current figures first.

Why do the analytics say "activity" rather than tokens?

Most of these services report how full a window is, not how many tokens you spent. When a real token count is unavailable, AI Quota builds the heatmap from the movement it observes and labels it as activity, because presenting that as a token total would be a fabrication. On a Mac, enabling local log reading in Settings gives true token counts, and those figures sync to your other devices.

Team and enterprise accounts

AI Quota supports personal accounts. Team, business and enterprise plans report usage through administrator APIs that a personal app cannot read.

Refunds

Purchases and refunds are handled by Apple. Request a refund through reportaproblem.apple.com.