Remaining capacity
How much is left
The share of your weekly allowance still available, read from each provider's own limits rather than estimated from your activity.
Reserve: Know what you have left.
Reserve keeps Codex, Claude, and Grok subscription capacity visible from your Mac menu bar: what remains, when it resets, and whether your current pace will last.
macOS 14 Sonoma or later · Universal 2 (Apple silicon and Intel) · MIT licensed
Always in the menu bar
What you get
Three numbers, and what they mean together.
A percentage on its own will not tell you whether you are about to be stopped mid-task. Reserve reads what each provider reports, compares it against how fast you are actually going, and leads with a single conclusion before you read a single card.
Reset time
When it comes back
The exact day and time the window rolls over, with a live countdown, so a low number late in the week reads differently from a low number on Monday.
Pace
Whether it will last
A marker on the bar shows where you ought to be right now. Reserve compares your rate against it and projects the outcome: in reserve, on pace, or running out, with the amount and the day.
Shorter windows sit underneath the weekly bar, so a healthy week can still warn you about this afternoon. Each card also shows whether that service is reporting problems, taken from its own official status page, so you can tell an outage from an exhausted allowance.
A closer look
The rest of the app.
Four views, drawn by the application itself from sample data rather than mocked up for this page.
-
The dashboard
Every subscription you track, with the conclusion stated at the top.
-
A provider, expanded
Tokens today, the last thirty days, estimated value, and where every figure came from.
-
When a plan runs out
The card changes colour and says what happened, and when it comes back.
-
In the menu bar
Let it follow whichever plan needs attention, or pin one and leave it there.
Supported subscriptions
Codex, Claude, and Grok.
Reserve reads the subscriptions you already hold. You do not need all three: turn off the ones you do not use and Reserve tracks the rest.
OpenAI Codex
Weekly allowance and the shorter session window, with the plan name Reserve reads back from your subscription.
Anthropic Claude
Weekly allowance, the shorter session window, and the separate model-specific weekly limit where your plan has one.
xAI Grok
The shared weekly allowance, plus its split across Grok's own tools when the subscription reports that breakdown.
Local first
It runs on your Mac, and stays there.
Reserve has no account of its own and no server of its own. It uses the sign-ins already present on your Mac, asks each provider for your limits over their own HTTPS endpoints, and reads local usage records to work out how much you have used.
- No Reserve account, and no password is ever handed to Reserve. Signing in happens on the provider's own website, in your browser.
- No prompts, responses or transcripts are stored, anywhere.
- No browser automation, no hidden web views, and no reading of browser cookies.
- No analytics and no telemetry. Reserve talks to the AI services you already pay for, their official status pages, and GitHub when you ask it to check for an update.
- Two small cache files hold aggregate limit snapshots and daily usage totals, capped at 100 KB and 12 MB.
One case is worth stating plainly. Claude sometimes keeps its sign-in in the macOS Keychain rather than in a file. Reserve does not read that item unless you switch it on yourself in Settings, and when it does, macOS handles the request and attributes it to Reserve by name.
Requirements
What you need to run it.
- Operating system
- macOS 14 Sonoma or later
- Architecture
- Universal 2
- Apple silicon
- native
- Intel
- native
- Licence
- MIT
- Price
- free
Reserve uses the installed official Codex, Claude and Grok command line tools for authenticated access. It does not install or update them, and it names any it cannot find.
Installation
Four steps, no setup wizard.
-
Download the disk image
Use the download button above. It gives you Reserve.dmg from the latest GitHub release.
-
Open the DMG
Double-click Reserve.dmg in your Downloads folder. A window opens showing Reserve alongside a shortcut to your Applications folder.
-
Drag Reserve to Applications
Drag the Reserve icon onto the Applications shortcut in that window. Then eject the disk image.
-
Open Reserve
Launch it from Applications. Reserve appears in your menu bar, finds the provider tools you have, and starts reading your limits. Anything signed out gets a Connect button that opens that provider's own sign-in page in your browser.
Open source
MIT licensed, and readable end to end.
Reserve is released under the MIT licence. The full source is on GitHub: you can read exactly what it requests, what it stores, and what it never touches, and you can build it yourself rather than trusting the download.
The licence and third-party notices are bundled inside the application and readable from its About panel. Reserve has no third-party package dependencies; the notices cover a small number of adapted implementation patterns and the official provider marks used inside the app.
Questions
Frequently asked.
Does Reserve need my passwords or API keys?
No. Reserve never asks for a password and never stores one.
It uses the sign-ins your provider tools already hold on your Mac. If one is signed
out, Reserve starts that provider's own sign-in and opens it in your browser, where
you sign in with them directly.
Do I need all three subscriptions?
No. Reserve tracks whichever of Codex, Claude and Grok you
have. Turn the others off in Settings and they disappear from the dashboard and the
menu bar.
Does it send my usage anywhere?
No. There is no analytics, no telemetry and no Reserve
server. Network requests go to the AI services you already pay for, their official
status pages, and GitHub when you ask Reserve to check for an update.
Will it slow my Mac down?
It is built not to. Reserve targets under 0.2% processor use
and under 80 MB of memory while idle, measured on the packaged application before
each release. Scheduled refreshes are skipped entirely in Low Power Mode.
How often does it check?
You choose: every 1, 5, 10, 15 or 30 minutes for provider
limits. Service status is checked at most every 10 minutes, and local usage is
counted every 30 minutes or immediately when you refresh by hand.
Is the estimated value a real bill?
No. Reserve estimates what your usage would have cost at
published pay-as-you-go prices, using its own arithmetic, so treat it as a ballpark.
It is closer for providers that report a detailed breakdown and rougher for those
that report a single total.
Where does Reserve store data on my Mac?
In two files under
~/Library/Application Support/Reserve/. They hold daily
totals and cached limit snapshots, capped at 100 KB and 12 MB. Deleting them
clears cached history and current snapshots, but not your provider sign-ins.
Can I build it myself instead of downloading?
Yes. Clone the repository and run
make run. You need the Apple Command Line Tools; there
are no other build dependencies.
Know what you have left.
Free, open source, and it stays on your Mac.
macOS 14 Sonoma or later · Universal 2 · MIT licensed