<div align="center"
</div
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. <br / I drop new open-source work every week. Don't miss the next one. | <img alt="GitHub Follow" src="https://img.shields.io/github/followers/junhoyeo?style=flat-square&logo=github&labelColor=black&color=24292f" width="156px" / | Follow @junhoyeo on GitHub for more projects. Hacking on AI, infra, and everything in between. | | :-----| :----- | <img alt="Discord link" src="https://img.shields.io/discord/1480206352755458110?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square" width="156px" / | Come hang out in our Discord — and surround yourself with the world's top-tier vibers. | <img alt="Sponsor Tokscale" src="https://img.shields.io/badge/sponsor-Tokscale-EA4AAA?style=flat-square&logo=githubsponsors&logoColor=white&labelColor=black" width="156px" / | Support Tokscale's continued development through GitHub Sponsors. |
<div align="center"
🇺🇸 English | 🇰🇷 한국어 | 🇯🇵 日本語 | 🇨🇳 简体中文
</div
| Overview | Models | |:---:|:---:| | | |
| Daily Summary | Stats | |:---:|:---:| | | |
| Frontend (3D Contributions Graph) | Wrapped 2025 | |:---:|:---:| | <a href="https://tokscale.ai"<img alt="Frontend (3D Contributions Graph)" src=".github/assets/frontend-contributions-graph.png" width="700px" /</a | <a href="#wrapped-2025"<img alt="Wrapped 2025" src=".github/assets/wrapped-2025-agents.png" width="700px" /</a |
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 | |------|----------|---------------| | <img width="48px" src=".github/assets/client-opencode.png" alt="OpenCode" / | OpenCode | ~/.local/share/opencode/opencode.db (1.2+, all channels including opencode-stable.db) or/and ~/.local/share/opencode/storage/message/ (legacy/unmigrated) | | <img width="48px" src=".github/assets/client-claude.jpg" alt="Claude" / | Claude Code | ~/.claude/projects/ and ~/.claude/transcripts/ | | <img width="48px" src=".github/assets/client-openclaw.jpg" alt="OpenClaw" / | OpenClaw | ~/.openclaw/agents/ (+ legacy: .clawdbot, .moltbot, .moldbot) | | <img width="48px" src=".github/assets/client-openai.jpg" alt="Codex" / | Codex CLI | ~/.codex/sessions/ | | <img width="48px" src=".github/assets/client-sakana.png" alt="Sakana Fugu" / | Sakana Fugu | via Codex — ~/.codex/sessions/.jsonl (modelprovider: sakana) | | <img width="48px" src=".github/assets/client-copilot.jpg" alt="Copilot" / | GitHub Copilot CLI | ~/.copilot/otel/.jsonl (+ COPILOTOTELFILEEXPORTERPATH) | | <img width="48px" src=".github/assets/client-hermes.png" alt="Hermes Agent" / | Hermes Agent | $HERMESHOME/state.db and $HERMESHOME/profiles//state.db (fallback: ~/.hermes/...) | | <img width="48px" src=".github/assets/client-gemini.png" alt="Gemini" / | Gemini CLI | $GEMINICLIHOME/tmp//chats/.json (fallback: ~/.gemini/tmp//chats/.json) | | <img width="48px" src=".github/assets/client-cursor.jpg" alt="Cursor" / | Cursor IDE | Cursor API export cached at ~/.config/tokscale/cursor-cache/usage.csv (desktop auto-login or cookie paste; not ~/.cursor) | | <img width="48px" src=".github/assets/client-amp.png" alt="Amp" / | Amp (AmpCode) | ~/.local/share/amp/threads/ | | <img width="48px" src=".github/assets/client-codebuff.png" alt="Codebuff" / | Codebuff | ~/.config/manicode/ (+ manicode-dev, manicode-staging; override via CODEBUFFDATADIR) | | <img width="48px" src=".github/assets/client-droid.png" alt="Droid" / | Droid (Factory Droid) | ~/.factory/sessions/ | | <img width="48px" src=".github/assets/client-pi.png" alt="Pi" / | Pi | ~/.pi/agent/sessions/ and ~/.omp/agent/sessions/ (Oh My Pi) | | <img width="48px" src=".github/assets/client-kimi.png" alt="Kimi" / | Kimi CLI / Kimi Code | kimi-cli: ~/.kimi/sessions/ kimi-code: ~/.kimi-code/sessions/ (override via KIMICODEHOME) | | <img width="48px" src=".github/assets/client-qwen.png" alt="Qwen" / | Qwen CLI | ~/.qwen/projects/ | | <img width="48px" src=".github/assets/client-roocode.png" alt="Roo Code" / | Roo Code | ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/tasks/ (+ server: ~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/tasks/) | | <img width="48px" src=".github/assets/client-kilocode.png" alt="Kilo" / | Kilo | ~/.config/Code/User/globalStorage/kilocode.kilo-code/tasks/ (+ server: ~/.vscode-server/data/User/globalStorage/kilocode.kilo-code/tasks/) | | <img width="48px" src=".github/assets/client-kilocode.png" alt="Kilo CLI" / | Kilo CLI | ~/.local/share/kilo/kilo.db | | <img width="48px" src=".github/assets/client-mux.png" alt="Mux" / | Mux | ~/.mux/sessions/ | | <img width="48px" src=".github/assets/client-crush.png" alt="Crush" / | Crush | $XDGDATAHOME/crush/projects.json (project registry; fallback: ~/.local/share/crush/projects.json) | | <img width="48px" src=".github/assets/client-goose.png" alt="Goose" / | Goose | ~/.local/share/goose/sessions/sessions.db (+ macOS Application Support, legacy Block/goose paths; override via GOOSEPATHROOT) | | <img width="48px" src=".github/assets/client-antigravity.png" alt="Antigravity" / | Google Antigravity | Cached via tokscale antigravity sync to ~/.config/tokscale/antigravity-cache/sessions/.jsonl (live RPC against the local language server) | | <img width="48px" src=".github/assets/client-antigravity.png" alt="Antigravity CLI" / | Antigravity CLI | ~/.gemini/antigravity-cli/conversations/.db (override the Gemini home via GEMINICLIHOME; local SQLite, read directly — no antigravity sync needed) | | <img width="48px" src=".github/assets/client-trae.png" alt="Trae" / | Trae IDE / Trae Solo (international) | Cached via tokscale trae sync to ~/.config/tokscale/trae-cache/sessions/.json (account-level usage from the official API) | | <img width="48px" src="https://github.com/warpdotdev.png" alt="Warp" / | Warp / Oz | Cached via tokscale warp sync to ~/.config/tokscale/warp-cache/usage.json (aggregate requests and spend only; no token transcripts) | | <img width="48px" src="https://github.com/xai-org.png" alt="Grok Build" / | Grok Build | $GROKHOME/sessions///updates.jsonl (fallback: ~/.grok/sessions///updates.jsonl) | | <img width="48px" src=".github/assets/client-zed.webp" alt="Zed Agent" / | 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) | | <img width="48px" src="https://github.com/kirodotdev.png" alt="Kiro" / | Kiro | ~/.kiro/sessions/cli/.json (+ .jsonl), ~/.local/share/kiro-cli/data.sqlite3 (macOS: ~/Library/Application Support/kiro-cli/data.sqlite3), and Kiro IDE globalStorage snapshots (Kiro/User/globalStorage/kiro.kiroagent; macOS Application Support, Linux ~/.config/Kiro, Windows %APPDATA%\Kiro) | | <img width="48px" src="https://github.com/cline.png" alt="Cline" / | Cline | VS Code globalStorage tasks (Linux: ~/.config/Code/...; macOS: ~/Library/Application Support/Code/...; Windows: %APPDATA%\Code\...; server: ~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/tasks/) | | <img width="48px" src="https://github.com/user-attachments/assets/7246e920-f3f8-4b6e-847e-030ae04e86c2" alt="Gajae-Code" / | gajae-code (gjc) | ~/.gjc/agent/sessions/ (override via GJCCODINGAGENTDIR, GJCCONFIGDIR, PICONFIGDIR; $XDGDATAHOME/gjc/sessions/ on Linux/macOS) | | <img width="48px" src=".github/assets/client-jcode.png" alt="Jcode" / | Jcode | ~/.jcode/sessions/session.json + session.journal.jsonl sidecars (override via JCODEHOME) | | <img width="48px" src="https://github.com/XiaomiMiMo.png" alt="MiMo Code" / | MiMo Code | ~/.local/share/mimocode/mimocode.db (XDG data dir; SQLite) | | <img width="48px" src="https://github.com/JetBrains.png" alt="Junie" / | Junie | ~/.junie/sessions//events.jsonl | | <img width="48px" src="https://raw.githubusercontent.com/CommandCodeAI/command-code/main/.github/commandcode/logo/command-code-logo-black-bg.png" alt="Command Code" / | Command Code | ~/.commandcode/projects//.jsonl (token usage estimated from transcripts at ~4 chars/token; not persisted on disk) | | <img width="48px" src="https://github.com/zai-org.png" alt="ZCode" / | ZCode | ~/.zcode/cli/db/db.sqlite (v2 usage database) and ~/.zcode/projects//.jsonl (legacy transcripts) | | <img width="48px" src="https://github.com/alibaba.png" alt="OpenCodeReview" / | OpenCodeReview | ~/.opencodereview/sessions//.jsonl | | <img width="48px" src="https://pc3.gtimg.com/softmgr/logo/48/43068481764842447.png" alt="CodeBuddy" / | CodeBuddy (CLI, IDE, VS Code plugin) | ~/.codebuddy/projects//.jsonl + extension logs | | <img width="48px" src="https://static.workbuddy.cn/web/agents/008054d6beaaf4a83e2d049e982e1244560726dc/assets/share-logo.png" alt="WorkBuddy" / | WorkBuddy | ~/.workbuddy/projects//.jsonl + SQLite fallback | | <img width="48px" src=".github/assets/client-devin.jpg" alt="Devin CLI" / | Devin CLI | ~/.local/share/devin/cli/sessions.db (SQLite) | | <img width="48px" src=".github/assets/client-devin.jpg" alt="Devin Desktop" / | Devin Desktop | ACP events: macOS ~/Library/Application Support/Devin/User/acp-events/; Linux ~/.config/Devin/User/acp-events/; Windows %APPDATA%\Devin\User\acp-events\ | | <img width="48px" src=".github/assets/client-synthetic.png" alt="Synthetic" / | Synthetic | Re-attributed from other sources via hf: model prefix or synthetic provider (+ Octofriend: ~/.local/share/octofriend/sqlite.db) |
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 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.