Your AI quotas,
right in the menu bar.
Remaining quota and reset countdowns for Claude Code, Codex, Cursor, Grok, GLM and 18+ services, all in one place. Provider credentials stay on your Mac. If you enable Apple-device sync, only an allowlisted AES-256-GCM encrypted quota snapshot moves through your own iCloud account.
macOS 14+· Apple Silicon (arm64)· public build coming later
TokenRemain is still under active development. No public DMG is available yet; follow progress on GitHub.
Real UI
Three screens, one pixel language
You've met the menu bar popover above — everything below is a live screenshot of the latest build: the desktop Dashboard, the iPhone app and Home Screen widgets.
Supported Providers
Supported services
Most services connect automatically the moment you're signed in: TokenRemain only reads credentials that already live on your machine — no extra login, no token refreshing. Every card says where its data comes from.
Official 5-hour / 7-day windows with reset countdowns. Direct oauth/usage queries, degrading to a PTY probe when credentials misbehave — refresh tokens are never touched.
Live 5-hour / 7-day windows for the main account. Direct server queries with local snapshot fallback; burn-ahead ETA when you're running hot.
Monthly billing-cycle quota and reset countdown. Read-only queries of state.vscdb.
Weekly pool remaining. Reads the Grok CLI's existing credentials.
Coding Plan session / weekly windows. The key lives only in your Keychain.
Monthly credits. Reads your local GitHub sign-in.
Daily / weekly quotas.
Prepaid credit balance.
Quota pools. Reads the local sign-in state.
Go plan usage, estimated from a local database scan — fully offline.
Credential locations and endpoints for every service are documented in the repo README; pace prediction uses real window progress and official reset times to judge whether your current pace lasts until reset.
Private by Design
Privacy isn't a promise. It's the architecture.
Every line below is a verifiable technical fact, not privacy-policy boilerplate — you can trace each one in the source.
Read-only credentials, never refreshed
Reads the access tokens your tools already maintain. Refresh tokens are never touched, nothing is written back — no fighting Claude Code or Cursor for their sessions.
Keys live in the Keychain
Manually added API keys (Z.ai, OpenRouter…) are stored only in the macOS Keychain — never in source, bundles or logs.
No servers of ours
Quota queries go straight to each provider's official API. TokenRemain runs no credential relay; optional Apple-device sync uses your private iCloud database.
No tracking, no analytics
No telemetry, no ads, no analytics SDK.
No account required
You never sign up for TokenRemain — being signed in to your local tools is enough.
Cache and stats stay local
Mac caches and cost statistics stay local. Only when you enable sync does an allowlisted, encrypted display snapshot enter your private iCloud database.
Current Build
Known limits of the development preview
TokenRemain is still being developed and is not a finished public release. These limits are deliberate trade-offs — data safety always outranks feature coverage.
- CHIPApple Silicon (arm64) only — no Intel builds yet.
- OSRequires macOS 14 Sonoma or later; macOS 26 gets native Liquid Glass, 14/15 fall back to the dark card style.
- DISTNo public DMG is available yet. This website is a development preview, not a release announcement.
- DEPSDirect quota queries need the matching tools signed in on this Mac (Claude Code, Codex CLI, Cursor…); services that aren't signed in show setup hints. Z.ai is the only one that needs a pasted API key.
- ESTCost figures are API list-price estimates, not your subscription bill; when a credential expires, data pauses and the app tells you how to recover.
Features
Keep your pace in hand
Pace prediction
Real window progress plus official reset times decide whether you'll make it to reset — with an ETA when you won't.
Menu bar & floating window
Choose which apps show in the menu bar; refresh every 1/5/15/30 min or manually; a floating window stays on top across Spaces.
Today's cost estimate
ccusage counts today's tokens and estimated API cost, split by provider, all computed locally.
AI feed
Quota resets, rate-limit changes and major model releases get pinned and trigger local macOS notifications.
Release
What happens before download
Development is in progress
Core product, privacy, signing, and cross-device behavior are still being completed and verified.
A public release will be announced
The website and GitHub repository will link to the official build only after it is ready for public use.
Install once it is available
Until then, there is no public DMG to download. Follow the repository for verified release updates.
All source, in the open
How credentials are read and where data goes — every line is auditable. Issues and PRs welcome.github.com/Carstin520/token-remain