by junhoyeo
🛰️ A CLI tool for tracking token usage from OpenCode, Claude Code, 🦞OpenClaw (Clawdbot/Moltbot), Pi, Codex, Gemini, Cursor, AmpCode, Factory Droid, Kimi, and more! • 🏅Global Leaderboard + 2D/3D Contributions Graph
# Add to your Claude Code skills
git clone https://github.com/junhoyeo/tokscaleA high-performance CLI tool and visualization dashboard for tracking token usage and costs across multiple AI coding agents.
[!TIP]
v2 is here — native Rust TUI, cross-platform support, and more. I drop new open-source work every week. Don't miss the next one.
| | Follow @junhoyeo on GitHub for more projects. Hacking on AI, infra, and everything in between. | | :-----| :----- | | Come hang out in our Discord — and surround yourself with the world's top-tier vibers. |
No comments yet. Be the first to share your thoughts!
🇺🇸 English | 🇰🇷 한국어 | 🇯🇵 日本語 | 🇨🇳 简体中文
| Overview | Models |
|:---:|:---:|
|
|
|
| Daily Summary | Stats |
|:---:|:---:|
|
|
|
| Frontend (3D Contributions Graph) | Wrapped 2025 | |:---:|:---:| | | |
Run
bunx tokscale@latest submitto submit your usage data to the leaderboard and create your public profile!
Tokscale helps you monitor and analyze your token consumption from:
| Logo | Client | Data Location | Supported |
|------|----------|---------------|-----------|
| | OpenCode | ~/.local/share/opencode/opencode.db (1.2+, all channels including opencode-stable.db) or/and ~/.local/share/opencode/storage/message/ (legacy/unmigrated) | ✅ Yes |
| | Claude Code | ~/.claude/projects/ | ✅ Yes |
| | OpenClaw | ~/.openclaw/agents/ (+ legacy: .clawdbot, .moltbot, .moldbot) | ✅ Yes |
| | Codex CLI | ~/.codex/sessions/ | ✅ Yes |
| | Hermes Agent | $HERMES_HOME/state.db (fallback: ~/.hermes/state.db) | ✅ Yes |
| | Gemini CLI | ~/.gemini/tmp/*/chats/*.json | ✅ Yes |
| | Cursor IDE | API sync via ~/.config/tokscale/cursor-cache/ | ✅ Yes |
| | Amp (AmpCode) | ~/.local/share/amp/threads/ | ✅ Yes |
| | Droid (Factory Droid) | ~/.factory/sessions/ | ✅ Yes |
| | Pi | ~/.pi/agent/sessions/ and ~/.omp/agent/sessions/ (Oh My Pi) | ✅ Yes |
| | Kimi CLI | ~/.kimi/sessions/ | ✅ Yes |
| | Qwen CLI | ~/.qwen/projects/ | ✅ Yes |
| | Roo Code | ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/tasks/ (+ server: ~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/tasks/) | ✅ Yes |
| | Kilo | ~/.config/Code/User/globalStorage/kilocode.kilo-code/tasks/ (+ server: ~/.vscode-server/data/User/globalStorage/kilocode.kilo-code/tasks/) | ✅ Yes |
| | Mux | ~/.mux/sessions/ | ✅ Yes |
| | Kilo CLI | ~/.local/share/kilo/kilo.db | ✅ Yes |
| | Crush | $XDG_DATA_HOME/crush/projects.json (project registry; fallback: ~/.local/share/crush/projects.json) | ✅ Yes |
| | Synthetic | Re-attributed from other sources via hf: model prefix or synthetic provider (+ Octofriend: ~/.local/share/octofriend/sqlite.db) | ✅ Yes |
Get real-time pricing calculations using 🚅 LiteLLM's pricing data, with support for tiered pricing models and cache token discounts.
This project is inspired by the Kardashev scale, a method proposed by astrophysicist Nikolai Kardashev to measure a civilization's level of technological advancement based on its energy consumption. A Type I civilization harnesses all energy available on its planet, Type II captures the entire output of its star, and Type III commands the energy of an entire galaxy.
In the age of AI-assisted development, tokens are the new energy. They power our reasoning, fuel our productivity, and drive our creative output. Just as the Kardashev scale tracks energy consumption at cosmic scales, Tokscale measures your token consumption as you scale the ranks of AI-augmented development. Whether you're a casual user or burning through millions of tokens daily, Tokscale helps you visualize your journey up the scale—from planetary developer to galactic code architect.