Skip to content

jeongwookie/WhereMyTokens

Repository files navigation

WhereMyTokens icon

WhereMyTokens

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

Codex tracking supported Antigravity supported Claude Code supported Local only

Windows 10 and 11 Release v1.19.2 MIT license

한국��� · 日本語 · 中文 · 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
WhereMyTokens dark overview collage
Light Overview
WhereMyTokens light overview collage

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.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
v1.18.1 Jun 4 Stabilize Antigravity quota selection, startup warmup, account labels, and model token stats

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.
  • 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.

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