MacOS : QuotAI Keeps an Eye On Your AI Credits

Background

It happens to anyone who vibe-codes late at night without noticing: you run out of tokens at the worst possible moment. Had you known it was coming, you could have planned a break — but you're not always typing /status or /usage, and doing so breaks your flow anyway. What if your quota was simply always visible, no matter what you were doing?

Introducing QuotAI

QuotAI (yes, you got it — Quota + AI) is a small, native macOS menu-bar app that keeps the remaining usage of your AI coding tools in view at all times. Claude's 5-hour and weekly limits, Codex's session and weekly limits, your OpenAI or Claude API spend — all in one floating panel that sits quietly above whatever else you're working in.

Seeing it coming gives you time to wrap up a thought, summarise the work so far, and hand off cleanly to another provider — instead of hitting a wall mid-task.

What it looks like

The panel comes in two flavors. Normal mode shows each provider's gauge and when it resets, at a glance. Mini mode strips it down to just the name and the percentage, for when screen space is at a premium. Switch between them anytime from the right-click menu or Settings — it's your call.

One panel, every provider

QuotAI currently tracks:

• Claude (Pro/Max subscription) — the 5-hour and weekly rate limits, read straight from Claude Code's own statusLine data.
• Claude API (Console) — month-to-date cost and token usage from Anthropic's Admin API.
• Codex (ChatGPT subscription) — session and weekly limits, straight from the Codex CLI.
• OpenAI API (platform) — month-to-date cost and token usage from OpenAI's Admin API.

Click any provider in the panel and a Details window opens with the full breakdown: every metric the provider exposes (not just the one shown in the panel), exactly when each one resets, and a plain note whenever a number is official data from the provider versus something you typed in yourself. It also shows when the data was last fetched, so you always know how fresh it is.

Of course, you can see the details for all of them and all at once if you need to make comparison :

What would be an app without customisation and strong settings !

Setting up Claude

Three of the four connections are a straightforward "paste a key" or "it just works off your existing CLI login." Claude — the Pro/Max subscription — is the exception, and it earns its own paragraph.

Anthropic doesn't expose a public API for subscription rate limits. The only place that data exists is Claude Code's own statusLine feature — a setting that runs a command of your choice and hands it the session's rate-limit JSON on every prompt. QuotAI piggybacks on that:

• In QuotAI's Settings, open the Claude connection and click Install Helper Script. It writes a small script to ~/Library/Application Support/QuotAI/ that does exactly one thing: copy whatever Claude Code sends it to a local file.
• Click Copy Snippet, then paste it into ~/.claude/settings.json — QuotAI shows you exactly what to add and never edits that file itself. Already have a statusLine command? Merge the two, don't overwrite it.
• Run Claude Code and send at least one message. The rate-limit data only exists once Claude Code has actually produced it — nothing shows up before that first response.

Back in QuotAI, hit Test Connection to confirm it's reading real data.

It's three clicks and one pasted snippet, not minutes of API-key hunting — but it is a genuinely different flow from the other three providers, so don't be surprised if Claude shows "bridge not installed" the first time, before you've gone through the steps above.

Click any provider in the panel and a Details window opens with the full breakdown: every metric the provider exposes (not just the one shown in the panel), exactly when each one resets, and a plain note whenever a number is official data from the provider versus something you typed in yourself. It also shows when the data was last fetched, so you always know how fresh it is.

Built to be trusted

Nothing about QuotAI asks for your password. Every connection authenticates the way the provider actually supports it — an official local bridge for Claude Code, the Codex CLI's own session, or an Admin API key you paste in once. Whatever key you do provide lives only in the macOS Keychain; QuotAI never logs it, writes it to disk, or sends it anywhere but that provider's own API. Every connector is also labeled honestly: metrics are marked "Official" when they come straight from the provider, or "Entered by you" when they don't — QuotAI never guesses a number and passes it off as real data.

Make it yours

Settings is a real macOS preferences window — a sidebar on the left, grouped sections on the right, each provider identified by its own logo — not an afterthought bolted onto the app :

• Panel — keep it above other windows, show it at launch, add a subtle border for visibility on light backgrounds, switch Normal and Mini mode, dial in opacity, reset its position.
• Status colors — set your own orange and red thresholds instead of the 60%/80% defaults, so the panel warns you exactly when it matters for your own usage pattern.
• Connections — enable or disable any provider, reorder them by drag and drop (the same order shows in the panel and in Details), and pick which one drives the main value shown when a provider reports several metrics.
• System — launch at login, choose what the compact view shows (reset time, remaining quota, last update time).

Small things, but they add up to a tool that gets out of your way instead of asking for attention.

Get it

QuotAI is free and open source, built for macOS 14 and later. It ships as a universal binary, compiled natively for both Apple Silicon and Intel — no Rosetta translation layer needed on either.

You can find it on my GitHub

I hope this helps ;)