WhereMyTokens for macOS

Claude Code, Codex, and Antigravity usage, live in your macOS menu bar.

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

Download · First Run · Screenshots · Windows Edition

WhereMyTokens for macOS is a local-first menu bar 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

Download

Platform	Download	Best For
macOS Apple Silicon	DMG Installer	Drag-to-Applications install
macOS Apple Silicon	ZIP App Archive	Simple archive install
Windows 10/11	Windows Edition	Tray app with installer and portable ZIP

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

The current macOS build is ad-hoc signed but not Apple notarized. Until Developer ID signing and notarization are added, macOS may show an unidentified-developer warning on first launch. For testing, right-click the app and choose Open, or use System Settings -> Privacy & Security -> Open Anyway.

First Run

1. Download the DMG, open it, and drag WhereMyTokens.app into /Applications.
2. Launch WhereMyTokens from /Applications.
3. Open the dashboard from the macOS menu bar.
4. Enable the providers you use: Claude Code, Codex, Antigravity, or any combination.
5. Optional: enable Claude Code Integration to register the statusLine bridge for live Claude context and fallback quota data.

Default local data location:

~/Library/Application Support/WhereMyTokens

What's New

Version	Date	Highlights
v1.0.0	Jun 17	Start the independent macOS release track with menu bar packaging, DMG/ZIP artifacts, macOS data paths, Claude/Codex/Antigravity usage tracking, and Claude Desktop credential discovery

Highlights

• macOS menu bar app with Dock hidden on startup.
• 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.
• 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.

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