WhereMyTokens

Claude Code, Codex, and Antigravity token usage, live in your Windows tray.

한국어 · 日本語 · 中文 · Español

Download · First Run · Screenshots · macOS Edition

WhereMyTokens is a local-first desktop app for monitoring AI coding usage: quota windows, token totals, cost estimates, cache efficiency, sessions, model usage, activity patterns, and git output.

Dark Overview
Light Overview

Built by a Korean developer who uses Claude Code daily, scratching my own itch.

Download

Platform	Download	Best For
Windows 10/11	Installer (.exe)	Normal installation, auto-start from the tray
Windows 10/11	Portable ZIP	No installer, keep it anywhere
macOS Apple Silicon	macOS Edition	Menu bar app with DMG/ZIP packaging

Looking for the menu bar version? See the separate WhereMyTokens for macOS repository, which has its own mac-vX.Y.Z release track and DMG/ZIP downloads.

By downloading or installing, you agree to the End-User License Agreement.

First Run

1. Install with WhereMyTokens-Setup.exe, or extract the portable ZIP and run WhereMyTokens.exe.
2. Open the dashboard from the Windows tray.
3. Enable the providers you use: Claude Code, Codex, Antigravity, or any combination.
4. Optional: enable Claude Code Integration to register the statusLine bridge for live Claude context and fallback quota data.

What's New

Version	Date	Highlights
v1.20.0	Jul 7	Add Codex reset-credit availability in Plan Usage and an optional self-contained Windows taskbar mini quota display with draggable 5H/1W rows
v1.19.2	Jun 22	Stabilize Trend breakdown imports for short Claude thinking blocks by widening the calibration guard
v1.19.1	Jun 22	Fix Claude JSONL discovery so agent logs contribute to usage graphs without adding agent-only session rows
v1.19.0	Jun 17	Add clickable Trend breakdowns with provider input/output, thinking/response/tool usage, cache-aware work/billing tokens, and git net-line categories
v1.18.2	Jun 5	Fix long Rich quota card titles so Plan Usage columns stay aligned

Full changelog

Highlights

• provider checkboxes for Claude Code, Codex, Antigravity, or any combination.
• Provider adapters live under src/main/providers/ so future providers can join the same quota/session/usage shape.
• Live Claude Code, Codex, and Antigravity quota cards with reset windows.
• Optional draggable Windows taskbar mini display for fixed 5H and 1W quota rows with transparent, taskbar-background-aware rendering.
• Codex reset-credit availability can appear as a separate Plan Usage target, with Rich, Simple, or hidden display modes in Settings.
• Active and recent session tracking from local provider data.
• Today and all-time token, cost, cache, model, and call summaries.
• Activity heatmaps, rhythm charts, model usage, and tool breakdowns.
• Git output metrics for current session repos.
• Persistent totals use usage-ledger.json; Rebuild ledger in Settings can reset and replay local history.
• Local-first storage with no cloud sync or telemetry.

Privacy

WhereMyTokens reads local provider files and only calls provider usage endpoints for enabled providers. It does not upload session logs, run cloud sync, or ask you to paste API keys.

Claude quota polling uses the Claude Code CLI credential file at ~/.claude/.credentials.json; Claude Desktop or browser login does not automatically refresh that local CLI credential.

Codex live usage and reset-credit checks use ~/.codex/auth.json only for direct OpenAI/ChatGPT requests when Codex is enabled. Reset-credit cache stores counts, expiry times, fetch status, source labels, a hashed auth marker, and the auth file modified time.

Antigravity uses local RPC only. It does not use Google OAuth, refresh tokens, Google cloud usage endpoints, or offline database fallback.

See Privacy and Security for the full data-source list.

More

Topic	Link
Feature details	docs/features.md
Privacy and security	docs/privacy-security.md
Development and architecture	docs/development.md
Release guide	RELEASE.md

License

MIT