tokscale

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

🇺🇸 English | 🇰🇷 한국어 | 🇯🇵 日本語 | 🇨🇳 简体中文

| Overview | Models | |:---:|:---:| | | |

| Daily Summary | Stats | |:---:|:---:| | | |

| Frontend (3D Contributions Graph) | Wrapped 2025 | |:---:|:---:| | | |

Run bunx tokscale@latest submit to submit your usage data to the leaderboard and create your public profile!

Overview

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/ and ~/.claude/transcripts/ | ✅ Yes | | | OpenClaw | ~/.openclaw/agents/ (+ legacy: .clawdbot, .moltbot, .moldbot) | ✅ Yes | | | Codex CLI | ~/.codex/sessions/ | ✅ Yes | | | GitHub Copilot CLI | ~/.copilot/otel/*.jsonl (+ COPILOT_OTEL_FILE_EXPORTER_PATH) | ✅ Yes | | | Hermes Agent | $HERMES_HOME/state.db (fallback: ~/.hermes/state.db) | ✅ Yes | | | Gemini CLI | $GEMINI_CLI_HOME/tmp/*/chats/*.json (fallback: ~/.gemini/tmp/*/chats/*.json) | ✅ Yes | | | Cursor IDE | API sync via ~/.config/tokscale/cursor-cache/ | ✅ Yes | | | Amp (AmpCode) | ~/.local/share/amp/threads/ | ✅ Yes | | | Codebuff | ~/.config/manicode/ (+ manicode-dev, manicode-staging; override via CODEBUFF_DATA_DIR) | ✅ 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 | | | Kilo CLI | ~/.local/share/kilo/kilo.db | ✅ Yes | | | Mux | ~/.mux/sessions/ | ✅ Yes | | | Crush | $XDG_DATA_HOME/crush/projects.json (project registry; fallback: ~/.local/share/crush/projects.json) | ✅ Yes | | | Goose | ~/.local/share/goose/sessions/sessions.db (+ macOS Application Support, legacy Block/goose paths; override via GOOSE_PATH_ROOT) | ✅ Yes | | | Google Antigravity | Cached via tokscale antigravity sync to ~/.config/tokscale/antigravity-cache/sessions/*.jsonl (live RPC against the local language server) | ✅ Yes | | | Trae IDE / Trae Solo (international) | Cached via tokscale trae sync to ~/.config/tokscale/trae-cache/sessions/*.json (account-level usage from the official API) | ✅ Yes | | | Zed Agent | ~/.local/share/zed/threads/threads.db (macOS: ~/Library/Application Support/Zed/threads/threads.db; Windows: %LOCALAPPDATA%/Zed/threads/threads.db; hosted Zed models only, not external ACP agents) | ✅ Yes | | Kiro | Kiro | ~/.kiro/sessions/cli/*.json (+ *.jsonl) and ~/.local/share/kiro-cli/data.sqlite3 (macOS: ~/Library/Application Support/kiro-cli/data.sqlite3) | ✅ 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.

Why "Tokscale"?

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