Version 1.4 · Mac release + iPhone beta

Your AI quotas,
right in the menu bar.

Remaining quota and reset countdowns for Claude Code, Codex, Cursor, Windsurf, Grok, GLM and 21+ services — plus where today's tokens went, how fast each model answered and what it would cost. 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.

Download for Mac Join iPhone TestFlight GitHub Repo

macOS 14+· Universal (Apple Silicon + Intel)· Version 1.4.4 · Universal Mac

Mac: Developer ID signed and notarized. iPhone beta: iOS 18+, with the Mac companion and the same iCloud account.

21+AI coding tools and services with quota windows
15+local coding agents counted offline by ccusage
13display currencies for API list-price estimates
0credentials refreshed, copied or uploaded

Latest Release

See where every token goes

TokenRemain 1.4 adds a token-level view of your usage — what was input, output and cache, and how fast each model answered — plus an Account Management page, display currencies and Dock meters you choose. All of it computed on your Mac.

TOKEN MIX 1.4.2

Input, output and cache, counted apart

Trends splits every range — or any day you click — into input, output, cache write and cache read, and each model row gets its own composition bar. Older history keeps an unsplit cache total instead of guessing.

TOK/S 1.4.2

Output speed, measured locally

End-to-end tokens per second for each model, estimated from Claude Code and Codex session timestamps. Only appended log bytes are read, with a time and size budget.

ACCOUNTS 1.4.1

Account Management

One page for every tracked app: switch monitoring per app, pause or rename accounts, update credentials, and opt in to a combined view for same-plan accounts.

CURRENCY 1.4.2

Costs in your currency

Show API list-price estimates in 13 currencies using daily public reference rates. Official bills and balances always stay in their billing currency; with USD selected, no rate request is made.

DOCK 1.4.1

Dock meters you pick

The Dock icon's two meters can follow any tracked apps, with a live preview in Settings. Claude and Codex remain the default pair.

CLAUDE 1.4.0

Claude Desktop and Cowork, counted

Local totals now merge Claude Desktop and Cowork session logs with your Claude Code folders, deduplicated, with custom log folders on the Data Sources page.

WEB SESSION 1.4.0

Claude quota without the CLI

Paste your own claude.ai session on the Data Sources page to read Claude quota directly — kept in the local Keychain, with organization selection, cancellation, timeouts and retry backoff.

Real UI

Mac, iPhone, wrist — one design language

You've met the menu bar popover above — rendered live in your browser, not a screenshot. Everything below is a real screenshot: the Mac Dashboard is TokenRemain 1.4.2 running on real usage data; the iPhone and Apple Watch shots run the built-in demo scenario, so they carry its DEMO mark. Numbers use tabular system digits, and hierarchy comes from type rather than decoration.

TokenRemain Dashboard overview page: lowest remaining quota, today's tokens and estimated cost, usage donut by provider, official quotas and risk notes TokenRemain Dashboard limits page: per-provider official quota windows with segment bars, reset countdowns and pace reserve TokenRemain Dashboard trends page: stacked daily token bars per provider, a token-mix strip and quota-consumption curves TokenRemain Dashboard model detail for one day: token mix plus per-model usage with locally estimated tokens per second

Dashboard · OverviewReal local usage: today's tokens and estimated cost split by provider, with official quota progress, the projected runway and risk notes beside them.

Dashboard · LimitsEvery provider's official windows — 5-hour, 7-day and monthly pools — with reset countdowns and a pace reserve that turns red, with a run-out ETA, when you're ahead of budget.

Dashboard · TrendsStacked daily token bars per provider, the token mix for the range and quota-consumption curves, so weekly rhythm and spikes stand out at a glance.

Trends · Model detailClick any day: input, output, cache write and cache read for that day, each model's share, and its output speed estimated from local session logs.

iPhone · OverviewToday's tokens lead, every digit, with estimated cost and a global-percentile standing; the quota verdict sits one line below. Long-press and drag any card to rearrange the page.

iPhone · AI FeedThe curated feed as its own tab: a reading timeline with quota/token and major-update chips pinned first, and an on-device archive of every story you've seen.

iPhone · TrendsA remaining-quota curve over the synced history, plus daily stacks: 7 / 14 / 30-day ranges, tokens or cost.

Apple WatchFrosted open-arc gauges on the wrist: lowest remaining in the centre, one provider arc each, today's tokens and cost beside — plus an AI Feed page and watch-face complications.

TokenRemain medium Home Screen widget: lowest remaining 46%, LOW risk badge, robot mascot, Codex and Claude bars, reset countdown TokenRemain small Home Screen widget: lowest remaining 46%, per-provider bars and reset countdown
WidgetsMedium and small Home Screen widgets: lowest remaining, per-provider bars and a reset countdown at a glance.

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.

Claude CodeAUTO

Official windows stay under Claude; external routes such as DeepSeek keep the Claude card while naming the API that owns the balance.

CodexAUTO

Official windows stay under Codex; custom model providers keep the Codex card while naming the API that owns the quota.

CursorAUTO

Monthly billing-cycle quota and reset countdown. Read-only queries of state.vscdb.

GrokAUTO

Weekly pool remaining. Reads the Grok CLI's existing credentials.

DeepSeekAPI KEY

Pay-as-you-go account balance. The key lives only in your Keychain.

KimiAPI KEY

Coding session / weekly windows, via API key or kimi-auth. Stored only in your Keychain.

Z.ai GLMAPI KEY

Coding Plan session / weekly windows, on the Global or China endpoint you choose. The key lives only in your Keychain.

GLM TeamAPI KEY

China-region Team Plan quota pools. The JSON config lives only in your Keychain.

CopilotAUTO

Monthly credits. Reads your local GitHub sign-in.

WindsurfAUTO

Daily / weekly quotas from Windsurf's read-only local login state.

OpenRouterAPI KEY

Prepaid credit balance, official spend and per-key limits.

AntigravityAUTO

Quota pools, plus optional Claude / third-party pools. Reads the local sign-in state.

OpenCodeAUTO

Go plan usage stays local; configured third-party providers keep the OpenCode card while naming the API quota source.

Third-party APIAPI KEY

New API-compatible account balance APIs or a custom balance endpoint. The config lives only in your Keychain.

More services · incl. token-monitor compatibility
Devin Trae MiniMax MiMo Code Qoder Kiro Volcengine Alibaba Token Plan Ollama

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.

AI Feed

The AI news that moves your quota, pre-sorted

A curated feed of AI-industry posts, read straight inside the app — a full reading tab on iPhone with an on-device archive, a glance page on Apple Watch, a panel on the Mac Dashboard. Quota, rate-limit and reset changes get pinned to the top and pushed as notifications; ordinary industry chatter stays quiet below. No X account, no login, no keyword soup.

ROSTER

A fixed, curated roster — not an algorithm

Tier one follows official and first-party voices (@claudeai, @AnthropicAI, @OpenAI, @sama…) checked every 10 minutes. Tier two rotates a fixed 12-account whitelist ranked by real engagement. Original posts only — replies, reposts and quotes are rejected.

PRIORITY

Two priorities that actually matter

TOKEN RESET — quota, rate-limit or reset changes; MAJOR UPDATE — big model, API or price moves. Both are pinned and trigger a notification. Everything else scrolls by quietly as NORMAL.

ZERO-CRED

Reads like a public bulletin board

The app fetches the curated result as public data from the TokenRemain broadcast service. Your provider credentials, usage numbers and identity are never attached to the request — the feed doesn't know who you are.

NOTIFY

Notifications on your terms

Major-update notifications are optional and delivered through macOS / iOS system notifications. Turn them off and the feed simply stays a reading list.

— Illustrative sample items —

Data Security & Privacy

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 credential relay

Quota queries go straight to each provider's official API. The public feed, push service, and aggregate download counter never receive provider credentials; optional Apple-device sync uses your private iCloud database.

✓

No behavioral tracking

No telemetry, ads, cookies, or analytics SDK. The website keeps only one anonymous aggregate Mac download count.

✓

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.

Stays on your Mac
  • Provider credentials — read in place, never copied out.
  • API keys — macOS Keychain only.
  • Usage cache & cost stats — computed and kept locally.
Default state. Beyond the providers' own APIs, only the public price table — and public exchange rates if you pick a non-USD currency — are fetched, with nothing attached.
Your iCloud — optional
  • Allowlisted quota snapshot — percentages, countdowns, risk level.
  • AES-256-GCM encrypted before it enters your private database.
  • Off by default — one switch, and only between your own devices.
Snapshot fields are allowlisted in code — credentials can't be synced even by mistake.
tokenremain.com servers
  • One anonymous integer — the aggregate DMG download count.
  • The public AI feed — served to every client identically.
  • Never received — credentials, usage numbers, or identifiers.
No IP logs, no user agents, no per-download events — a single counter and its timestamp.
✓Sync: opt-in ✓Notifications: opt-in ✓Every card labels its data source ✓All source public & auditable Read the full privacy policy →

Brand

A logo that works for a living

The robot isn't decoration — its face is a gauge. One mascot drives the popover, Dashboard, iPhone app and widgets; your lowest remaining quota picks one of its eleven expressions. Meet them all:

TokenRemain robot head, calm expression at 70% remaining
70% ✓CALM

DRAG — OR PICK A SPRITE BELOW

TokenRemain app icon: dimensional pixel robot head over Claude and Codex quota bars — identical on macOS, iOS and watchOS App icon macOS · iOS · watchOS
Close-up of the TokenRemain menu bar capsule: Claude 89%, Codex 91% Menu bar
TokenRemain vector mark shown across a dark and light split background Mark · dark/light
TokenRemain Wordmark
Animated TokenRemain mascot, full body Mascot · motion

All marks shown at their production aspect ratios — nothing cropped, stretched or recolored. Provider glyphs (Claude starburst, Codex petals) follow each provider's official identity and never bleed into TokenRemain's own violet / cyan.

Current Release

Known limits of the Mac release

The notarized Mac release is available now. These limits are deliberate trade-offs — data safety always outranks feature coverage.

!Known limitations
  • CHIPUniversal Mac build — supports Apple Silicon (arm64) and Intel (x86_64).
  • OSRequires macOS 14 Sonoma or later; macOS 26 gets native Liquid Glass, 14/15 fall back to the dark card style.
  • DISTThe public DMG is Developer ID signed and Apple notarized. It is currently distributed outside the Mac App Store.
  • 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. Key-based services such as Z.ai, OpenRouter and DeepSeek need an API key pasted once.
  • 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

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

Menu bar & floating window

Choose which apps show in the menu bar and on the Dock icon's two meters; refresh every 1/5/15/30 min or manually; a floating window stays on top across Spaces.

COST

Today's cost estimate

ccusage counts today's tokens and estimated API cost by provider and model — input, output and cache apart, in your display currency — all computed locally.

AI FEED

AI feed

Quota resets, rate-limit changes and major model releases get pinned and trigger local macOS notifications. →

Release

Download and install

Download the notarized DMG

Use the official button above. The download is signed with Developer ID and notarized by Apple.

Move TokenRemain to Applications

Open the DMG and drag TokenRemain into the Applications shortcut.

Open and choose your providers

Launch TokenRemain from Applications and tick the local tools it found. Paste API keys where needed, then optionally enable Apple-device sync and AI Feed notifications.

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

Open the repo

TokenRemain is an independent app, not affiliated with, endorsed by, or sponsored by Anthropic, OpenAI, Anysphere, xAI, GitHub, Zhipu AI, or any other provider; service names and marks appear only to identify the services you can choose to connect. Cost figures are API list-price estimates; quota and pricing policies are defined by each provider's official pages.

© 2026 Dongheng Li Privacy Policy · Support · Report an issue