xTokens
Local-first macOS menu bar utility for inspecting AI coding agent token usage, cache efficiency, and 52-week activity heatmaps.
Shipping · v0.3.1
Platforms:
macOS 14.0+Universal2 (arm64 + x86_64)Menu BarZero Network
Application Screenshots
Captured on macOSKey Features
- Scans local JSONL session transcripts from Claude Code, Codex, and Gemini CLI directly on disk with zero network calls
- Renders a 52-week contribution-style cyan activity heatmap and daily/weekly/yearly token counters in the macOS menu bar
- Breaks down total token volume into input, output, prompt cache creation, and prompt cache read categories
- Tracks per-project and per-workspace token consumption and event counts across engineering repositories
- Incremental FSEvents log tailing updates counters in real time with minimal CPU and memory overhead
- 100% offline privacy guarantee: no API keys required and no transcript contents ever leave your Mac
System Requirements
- Operating System
- macOS 14.0 (Sonoma) or later · macOS 27.0 & 26.7 verified
- Architecture
- Universal2 binary (Apple Silicon arm64 & Intel x86_64)
- Code Signing
- Developer ID Application: east coast science, llc (ZU2882L4HT) · Apple Notarized
- Storage & Memory
- 14 MB application bundle · < 25 MB resident memory
- Privacy & Network
- Zero network entitlements · Reads local session transcript metadata only
What's New
v0.3.1 (Build 5) ·- Added 52-week cyan activity heatmap with Today, 7-Day, and 52-Week aggregate cards.
- Added per-project token and event leaderboard with instant search filtering.
- Optimized incremental JSONL parser to scan 100M+ token histories in under 400ms.
- Verified Universal2 notarized build on macOS 27.0 and macOS 26.7.