toktrack
v2.15.0
Published
Never lose your AI coding cost history — token & cost tracker for Claude Code, Codex, Gemini, Qwen Code, OpenCode & PI Agent, with a persistent cache that survives CLI data deletion.
Maintainers
Readme
toktrack
Ultra-fast token & cost tracker for Claude Code, Codex CLI, Gemini CLI, Qwen Code, OpenCode, PI Agent, and Antigravity. Built with Rust for ultra-fast performance (simd-json + rayon).
⚠️ Did you know? Claude Code deletes your session data after 30 days by default. Once deleted, your token usage and cost history are gone forever — unless you preserve them.

Why toktrack?
| Problem | Solution | |---------|----------| | 🐌 Existing tools are slow — 40+ seconds | ⚡ 1000x faster — cached queries in ~0.04s | | 🗑️ Claude Code deletes data after 30 days | 💾 Persistent cache — history survives | | 📊 No unified view — each CLI has separate data | 🎯 One dashboard — all CLIs in one place |
Installation
# No installation required
npx toktrack
# Or install globally
npm install -g toktrackHomebrew (macOS / Linux)
brew tap mag123c/toktrack
brew install toktrackFeatures
- Ultra-Fast Parsing — simd-json + rayon parallel processing (~3 GiB/s throughput)
- TUI Dashboard — 5 tabs (Overview, Stats, Models, Projects, Audit) with daily/weekly/monthly views
- Per-Project Breakdown — the Projects tab shows token & cost usage per project (the session working directory), for CLIs that record one. Drill into any project for its day-by-day, per-model breakdown. Usage from CLIs that don't record a project is grouped under
(no project). Project details are cached, so they survive past the CLI's 30-day deletion - Multi-CLI Support — Claude Code, Codex CLI, Gemini CLI, Qwen Code, OpenCode, PI Agent, Antigravity
- CLI Commands —
daily,weekly,monthly,statswith JSON output - Data Preservation — Cached daily summaries survive CLI data deletion
Supported AI CLIs
| CLI | Data Location |
|-----|---------------|
| Claude Code | ~/.claude/projects/ |
| Codex CLI | ~/.codex/sessions/ |
| Gemini CLI | ~/.gemini/tmp/*/chats/ |
| Qwen Code | ~/.qwen/tmp/*/chats/ |
| OpenCode | ~/.local/share/opencode/storage/message/ |
| PI Agent | ~/.pi/agent/sessions/ |
| Antigravity | ~/.gemini/antigravity-{ide,cli}/conversations/*.db |
Supported Platforms
| Platform | Architecture | |----------|-------------| | macOS | x64, ARM64 | | Linux | x64, ARM64 | | Windows | x64 |
Quick Usage
# Launch TUI dashboard
npx toktrack
# JSON output for scripting
npx toktrack daily --json
npx toktrack stats --jsonPerformance
| Tool | Time | Speedup | |------|------|---------| | Existing tools | 40s+ | baseline | | toktrack (cold) | ~1.0s | 40x faster | | toktrack (cached) | ~0.04s | 1000x faster |
Measured on Apple Silicon with 2,000+ JSONL files (3.4 GB).
Links
License
MIT
