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, Grok, Cursor, Copilot, Gemini, Z.ai, and Kimi Code 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.
Beside your limits, choose Today, 7 days or 30 days to see total tokens, a trend and each provider's share. The token mix separates input, cached, cache write and output tokens where recorded, with estimated cache savings and your top models. A label tells you how fresh the reading is.
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.
Select a provider to see every allowance and its reset time, so a healthy week can still warn you about this afternoon. Service-health labels come from the providers' official status sources where available.
A closer look
The rest of the app.
Five views, drawn by the application itself from sample data rather than mocked up for this page.
-
The dashboard
Limits and reset times beside usage, with the plan that needs attention named at the top.
-
Account insights
Only providers and sources with data in the chosen period appear. Cost is available only when a selected provider has a price for every active day. An outlined heatmap cell means no data, not zero.
-
A provider, expanded
Every allowance and reset, plus the account details the provider reports and when the limits were last checked.
-
When a plan runs out
The overview and selected details say which limit is exhausted and when it resets.
-
In the menu bar
Let it follow whichever plan needs attention, or pin OpenAI, Grok, or Cursor and leave it there.
Today in Insights shows hourly activity from the Claude and Codex logs on this Mac. History combines this Mac's logs with the account-wide daily totals Codex and Cursor report. The API-price estimate includes only providers with a known price for every active day. Providers without one, including Cursor and Codex, are named below the total and left out of it.
Supported subscriptions
Eight plans, one clear view.
Reserve reads the subscriptions you already hold. You do not need all eight: 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.
Cursor
Cursor Models and Other Models allowances, whole-number percentages, and provider-reported account usage for individual Cursor accounts.
GitHub Copilot
Remaining limited allowances from the signed-in Copilot CLI. This connection is experimental until it has been checked against a paid account.
Gemini Beta
Google AI Pro and Ultra 5-hour and weekly limits for each model group, read from the Antigravity CLI, agy 1.1.11 or later.
Z.ai GLM Coding Plan Beta
5-hour and weekly limits. Connect it by pasting an API key from the international z.ai platform.
Kimi Code Beta
5-hour and weekly limits for the Kimi Code subscription. Connect it by pasting a Kimi Code API key.
Gemini, Z.ai, and Kimi Code are in beta. Their usage formats have not yet been checked against every kind of account, and Z.ai and Kimi read usage from endpoints their makers have not documented. If Reserve cannot read one of them, it says so instead of showing a wrong number. If something looks wrong, please open an issue on GitHub and describe what you saw, without your key, account name or email.
API accounts
What your API keys have spent, or have left.
Pay-as-you-go accounts get their own section, below the plan cards. In Settings > API, paste a key and Reserve reads that account's spend or remaining balance from the provider's own endpoint. Each row is off until you save a key, and opens to show everything that key reports.
- OpenAI
- Organization admin key. Spend from the Costs API, by billing line item.
- Anthropic
- An organization-scoped personal or service-account key with billing access, or a legacy admin key. Spend from the Cost Report API, by model. A configured Claude Console organization is required; the Admin API is unavailable to Individual accounts. A key that works without spend access reads "Key works · spend unavailable".
- OpenRouter
- The API key itself. Spend today, this week and this month, and the credit balance when the key is capped.
- xAI
- Management key. The prepaid balance, and spend against purchased credits when the transactions explain it.
- DeepSeek
- The API key. Remaining balance, split into granted and topped-up credit, and whether it still allows calls.
- Moonshot
- An API key from the Kimi API platform. Remaining USD balance, split into vouchers and cash.
Keys stay in the macOS Keychain on this Mac, and each one is sent only to the provider that issued it. OpenAI and Anthropic admin keys and xAI management keys do not call models. Ordinary Anthropic, OpenRouter, DeepSeek, and Moonshot keys can also call models, so create one just for Reserve.
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 and official helpers already present on your Mac, plus any API keys you paste, asks each provider for your limits over their own HTTPS endpoints, and reads bounded local aggregates 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.
- Reserve does not store prompts, responses or transcripts. Cursor is never read through its transcripts.
- 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 for update checks.
- API keys you paste stay in the macOS Keychain and are sent only to the provider that issued them.
- Before running a provider's command-line tool, Reserve checks every folder and link on the way to it, and skips anything another account on the Mac could have replaced.
- Session and credential files are opened once and read only through that open file, so a file swapped mid-check is ignored.
- Bounded cache files hold limit snapshots and aggregate usage history. Prompts, responses and credentials are never cached.
Protected sign-ins stay behind macOS until you choose Allow usage access. Claude and Cursor can keep their credentials in Keychain; Reserve asks only for the specific access needed to refresh account data, keeps it in memory, and lets you turn access off again in Settings.
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 official Codex, Claude, Grok, Cursor, Copilot, and Antigravity helpers for authenticated access. Open Settings > Providers and choose Connect beside a provider. Reserve first checks for an existing sign-in, then guides you through only the needed steps in one window. If a helper needs installation or an update, it explains the change and waits for your approval. Browser sign-in opens in your regular Chrome profile, or your default browser if Chrome is not installed. Cursor support is for individual accounts, not Teams or Enterprise Admin API keys. Gemini needs the Antigravity CLI, agy 1.1.11 or later. Reserve can install it, but you sign in with Google by running agy once in Terminal. Z.ai and Kimi Code have no helper; Connect asks for an API key instead.
Installation
One download, then one clear action.
-
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 providers you have, and starts reading your limits.
-
Connect a provider
Open Settings > Providers and choose Connect beside the provider. Reserve checks for an existing sign-in first, then handles helper setup or update, provider sign-in, required macOS permission, and a fresh usage check in one window. It asks before installing or updating, opens sign-in in your regular Chrome profile or default browser, and lets you reopen that page or cancel the connection. For Z.ai and Kimi Code, paste an API key instead.
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 uses Sparkle for signed app updates. The notices cover Sparkle, adapted implementation patterns, and the provider marks used inside the app.
Questions
Frequently asked.
Does Reserve need my passwords or API keys?
Reserve never asks for a password and never stores one.
Choose Connect beside the provider in Settings > Providers
and Reserve checks for an existing sign-in
before opening the provider's own website in your regular Chrome profile, or your default
browser if Chrome is not installed. Your password stays with the provider. API keys are
needed only for the Z.ai and Kimi Code plans and for the optional API accounts. Each key
stays in the macOS Keychain and is sent only to the provider that issued it.
Which providers does Reserve support?
Reserve supports OpenAI Codex, Anthropic Claude, xAI Grok,
Cursor, GitHub Copilot, Gemini, the Z.ai GLM Coding Plan, and Kimi Code. Copilot support
is experimental, and Gemini, Z.ai, and Kimi Code are in beta. Turn off the ones you do
not use in Settings and they disappear from the dashboard and menu bar. Separately, it can
measure OpenAI, Anthropic, OpenRouter, xAI, DeepSeek, and Moonshot API accounts,
each off until you save a key.
Can I connect a provider without Terminal?
Yes, except to sign in to Gemini: agy has no separate sign-in
command, so run agy once in Terminal and sign in with Google
there. For everything else, choose Connect beside the provider in
Settings > Providers.
Reserve explains any helper installation or update, asks for approval, opens the provider's
browser sign-in, handles the required macOS permission, and waits for fresh usage before
showing the connection as complete. The window stays available while a refresh runs, and you
can reopen the browser page or cancel the connection.
How does Cursor usage work?
Cursor supplies the account totals. Reserve shows Cursor Models and
Other Models allowances as whole-number percentages, plus provider-reported tokens and model
totals for today and the last 30 days. It requests daily history separately and says
Daily history unavailable when Cursor supplies totals without daily events.
Do I need all eight subscriptions?
No. Reserve tracks whichever supported services you have.
Turn the others off in Settings and they disappear from the dashboard and 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 for update checks. Cursor account totals
come from Cursor's authenticated service and are not read from transcripts.
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?
Choose an adaptive interval or a fixed 1, 5, 10, 15 or 30 minutes for
provider limits. Adaptive checks range from 2 to 30 minutes. Service status is checked
at most every 10 minutes. Local history is read when you open Insights or the dashboard;
reopening the dashboard rescans changed logs when the last pass is over two minutes old.
Is the estimated value a real bill?
No. Reserve estimates what priced usage would have cost at published
pay-as-you-go prices. A provider is included only when every active day has a known
price; the others are named below the total. Estimated cache savings compare cached
reads with the full input price. They are not savings on your subscription bill.
Where does Reserve store data on my Mac?
Under ~/Library/Application Support/Reserve/.
Bounded cache files hold aggregate usage history and limit snapshots. Your provider
sign-ins stay in the provider's own store; API keys stay in the macOS Keychain.
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