tokentray

See it at a glance

Every tool you use gets a spot on the taskbar: session and weekly usage side by side, each number with its own reset — 03:00 when it's today, 2d when it's days away, and a 40m countdown in the last hour. Colors only change when something needs your attention.

Hover for the details

Rest the pointer on the widget and a card lists every limit with the exact time it refills. No clicking, no focus stolen.

Click for the whole picture

The panel reads your numbers back to you in one sentence per tool — plenty left, 87% used but this pace lasts until 04:00, or at this pace it runs out 2 hours before it refills — then lays out every window, plan and account. With three or more tools it opens into two columns.

The pace notch

Percentages tell you where you are. The notch tells you whether you'll make it. Every bar carries a mark for how much of its window has already passed; stay behind it and your allowance lasts until the reset.

Make it yours

Five taskbar styles — Rings, Dots, Cells, Bars, Simple — each with the tool's name or a compact icon. Choose what it shows (session, weekly, reset time), used or left, and a light, dark or system theme. Settings preview every option with your own numbers before you pick.

Supported tools

	Tool	Limits shown	Signed in via
	Claude Code — Pro, Max 5x, Max 20x	5-hour session, weekly, per-model weekly (e.g. Opus)	Claude Code CLI, or the Claude desktop app (same account only)
	Codex — ChatGPT Plus, Pro	5-hour session where your plan has one, weekly	Codex CLI
	Google Antigravity (Gemini)	5-hour and weekly for Gemini models, plus the Claude & GPT pool	Antigravity
	Grok Build	Weekly or monthly credit pool	Grok CLI
	Cursor	Included usage this billing month, API usage	Cursor
	OpenCode Go	5-hour, weekly, monthly	A workspace id and session cookie you provide

Tools found on your PC switch on by themselves; the rest are one toggle away in Settings → General.

Quick start

1. Download the zip for your PC from the latest release.
2. Unzip it anywhere and run TokenTray.exe. The panel opens once to show what it found.
3. Optional: Settings → General → Start with Windows.

[!NOTE] TokenTray isn't code-signed yet, so SmartScreen may ask the first time: More info → Run anyway. Each release ships SHA256SUMS.txt so you can check what you downloaded.

Requirements: Windows 10 (1809+) or Windows 11, x64 or ARM64, and at least one signed-in tool from the list above.

If Windows 11 tucks the tray icon under ^, drag it onto the taskbar to keep it in view.

Privacy and security

TokenTray has no server. It reads the sign-ins already on your PC and asks each tool's own usage endpoint — the same numbers the tool shows you — and nothing else leaves your machine.

flowchart LR
    S["Sign-ins already on your PC<br/>Claude Code, Codex, Antigravity, Grok, Cursor"] -- "read only" --> T(("TokenTray"))
    T -- "HTTPS, your own token" --> E["Each tool's official<br/>usage endpoint"]
    E -- "percentages and reset times" --> T
    T --> U["Taskbar widget<br/>panel and notifications"]

• Read-only. Tokens are never refreshed, copied or written. When a sign-in expires, open the tool once and it renews itself.
• No telemetry, no analytics, no accounts.
• Stays local: settings in %APPDATA%\TokenTray; the last reading and notification history in %LOCALAPPDATA%\TokenTray.
• Claude desktop app: its sign-in is encrypted for your Windows user. TokenTray decrypts it with Windows DPAPI, as the app does, and uses it only when it's the same account as your Claude Code CLI.

Found a vulnerability? Please report it privately — see SECURITY.md.

FAQ

Build from source

git clone https://github.com/emrecengdev/tokentray
cd tokentray
dotnet test                          # 50 unit tests, no network
dotnet run --project src/TokenTray   # run it
.\publish.ps1 -Version 1.1.0         # release zips + SHA256SUMS in .\dist

Requires the .NET 10 SDK. src/TokenTray.Core holds providers, polling, pace and caching with no UI; src/TokenTray is the WPF app.

Every image in this README is drawn by TokenTray itself from sample data — no screenshots of real accounts: TokenTray.exe --render-media docs\media, then python tools\make_hero.py docs\media.

Contributing

Reports from tools, plans and Windows setups we can't test ourselves are gold — Cursor, OpenCode Go, Grok monthly plans, Codex plans with a 5-hour window, Windows 10 and ARM64. See CONTRIBUTING.md.

If TokenTray saved you from a surprise limit, a ⭐ helps other people find it.

License

MIT © Emre Canik. Product names belong to their owners.