toktrack


Ultra-fast token & cost tracker for Claude Code, Codex CLI, Gemini CLI, and OpenCode. 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.

!toktrack overview

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

``bash


No installation required

npx toktrack

Or install globally

npm install -g toktrack
`

Features

- Ultra-Fast Parsing — simd-json + rayon parallel processing (~3 GiB/s throughput)
- TUI Dashboard — 4 views (Overview, Models, Daily, Stats) with daily/weekly/monthly breakdown
- Multi-CLI Support — Claude Code, Codex CLI, Gemini CLI, OpenCode
- CLI Commands — daily, weekly, monthly, stats with 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/ |
| OpenCode | ~/.local/share/opencode/storage/ |

Supported Platforms

| Platform | Architecture |
|----------|-------------|
| macOS | x64, ARM64 |
| Linux | x64, ARM64 |
| Windows | x64 |

Quick Usage

`bash


Launch TUI dashboard

npx toktrack

JSON output for scripting

npx toktrack daily --json
npx toktrack stats --json
``

Performance

| 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

- GitHub
- Documentation
- Releases
- Changelog

License

MIT