xTokens app icon

xTokens

v0.3.1 (Build 5)

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 macOS
xTokens Menu Bar Popover — 103.3M tokens tracked across 17,909 events with 52-week cyan heatmap
xTokens Menu Bar Popover — 103.3M tokens tracked across 17,909 events with 52-week cyan heatmap macOS Capture

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