tokscale README

The project's README from github.com/junhoyeo/tokscale. As one markdown file: README.md.

Tokscale

A high-performance CLI tool and visualization dashboard for tracking token usage and costs across multiple AI coding agents.

[!TIP]

I drop new open-source work every week. Don't miss the next one.

GitHub Follow Follow @junhoyeo on GitHub for more projects. Hacking on AI, infra, and everything in between.
Discord link Come hang out in our Discord — and surround yourself with the world's top-tier vibers.
Sponsor Tokscale Support Tokscale's continued development through GitHub Sponsors.

GitHub Release npm Version npm Downloads GitHub Contributors GitHub Forks GitHub Stars GitHub Issues License Coverage

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

Overview Models
TUI Overview TUI Models
Daily Summary Stats
TUI Daily Summary TUI Stats
Frontend (3D Contributions Graph) Wrapped 2025
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
OpenCode OpenCode ~/.local/share/opencode/opencode.db (1.2+, all channels including opencode-stable.db) or/and ~/.local/share/opencode/storage/message/ (legacy/unmigrated)
Claude Claude Code ~/.claude/projects/ and ~/.claude/transcripts/
OpenClaw OpenClaw ~/.openclaw/agents/ (*/agent/openclaw-agent.sqlite + */sessions/*.jsonl; + legacy: .clawdbot, .moltbot, .moldbot)
Codex Codex CLI ~/.codex/sessions/
Prime Agent Prime Agent ~/.prime/agent/sessions/ and ~/.prime/agent/session-artifacts/ (RLM child sessions)
Sakana Fugu Sakana Fugu via Codex — ~/.codex/sessions/*.jsonl (model_provider: sakana)
Copilot GitHub Copilot CLI ~/.copilot/otel/*.jsonl (+ COPILOT_OTEL_FILE_EXPORTER_PATH)
Hermes Agent Hermes Agent $HERMES_HOME/state.db and $HERMES_HOME/profiles/*/state.db (fallback: ~/.hermes/...)
Gemini Gemini CLI $GEMINI_CLI_HOME/tmp/*/chats/*.json (fallback: ~/.gemini/tmp/*/chats/*.json)
Cursor Cursor IDE Cursor API export cached at ~/.config/tokscale/cursor-cache/usage*.csv (desktop auto-login or cookie paste; not ~/.cursor)
Amp Amp (AmpCode) ~/.local/share/amp/threads/
Codebuff Codebuff ~/.config/manicode/ (+ manicode-dev, manicode-staging; override via CODEBUFF_DATA_DIR)
Freebuff Freebuff shares ~/.config/manicode/ with Codebuff (same runtime); token usage is estimated from the transcript (no local usage; override via FREEBUFF_DATA_DIR)
Droid Droid (Factory Droid) ~/.factory/sessions/
Pi Pi ~/.pi/agent/sessions/
Oh My Pi Oh My Pi ~/.omp/agent/sessions/**/*.jsonl
Senpi Senpi (OmO Native) ~/.senpi/agent/sessions/ (override via SENPI_CODING_AGENT_DIR)
Kimchi Kimchi Coding ~/.config/kimchi/harness/sessions/ (override via KIMCHI_CODING_AGENT_DIR)
Reasonix Reasonix ~/.reasonix/stats/*.jsonl (override via REASONIX_STATE_HOME or REASONIX_HOME)
Kimi Kimi CLI / Kimi Code kimi-cli: ~/.kimi/sessions/ kimi-code: ~/.kimi-code/sessions/ (override via KIMI_CODE_HOME) kimi-work: desktop app-data root (auto-discovered)
Qwen Qwen CLI ~/.qwen/projects/
Roo Code Roo Code ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/tasks/ (+ server: ~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/tasks/)
Kilo Kilo ~/.config/Code/User/globalStorage/kilocode.kilo-code/tasks/ (+ server: ~/.vscode-server/data/User/globalStorage/kilocode.kilo-code/tasks/)
Kilo CLI Kilo CLI ~/.local/share/kilo/kilo.db
Mux Mux ~/.mux/sessions/
Crush Crush $XDG_DATA_HOME/crush/projects.json (project registry; fallback: ~/.local/share/crush/projects.json)
Goose Goose ~/.local/share/goose/sessions/sessions.db (+ macOS Application Support, legacy Block/goose paths; override via GOOSE_PATH_ROOT)
Antigravity Google Antigravity Cached via tokscale antigravity sync to ~/.config/tokscale/antigravity-cache/sessions/*.jsonl (live RPC against the local language server)
Antigravity CLI Antigravity CLI ~/.gemini/antigravity-cli/conversations/*.db (override the Gemini home via GEMINI_CLI_HOME; local SQLite, read directly — no antigravity sync needed)
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)
Warp Warp / Oz Cached via tokscale warp sync to ~/.config/tokscale/warp-cache/usage.json (aggregate requests and spend only; no token transcripts)
Grok Build Grok Build $GROK_HOME/sessions/*/*/updates.jsonl (fallback: ~/.grok/sessions/*/*/updates.jsonl)
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)
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)
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/) + Cline CLI sessions (first available root, in order: $CLINE_SESSION_DATA_DIR, $CLINE_DATA_DIR/sessions/, $CLINE_DIR/data/sessions/, fallback ~/.cline/data/sessions/; blank/whitespace-only environment values are ignored)
Gajae-Code gajae-code (gjc) ~/.gjc/agent/sessions/ (override via GJC_CODING_AGENT_DIR, GJC_CONFIG_DIR, PI_CONFIG_DIR; $XDG_DATA_HOME/gjc/sessions/ on Linux/macOS)
Cherry Studio Cherry Studio %APPDATA%\CherryStudio\Data\Agents\.claude\projects\*.jsonl and legacy %APPDATA%\CherryStudio\.claude\projects\*.jsonl (macOS: ~/Library/Application Support/CherryStudio/Data/Agents/.claude/projects/; Linux: $XDG_CONFIG_HOME/CherryStudio/Data/Agents/.claude/projects/; Agent / Claude Code mode transcripts; V2 root preferred, legacy keeps untransferred history)
LM Studio LM Studio ~/.lmstudio/server-logs/**/*.log (LM_STUDIO_HOME supported; Chat Completions and Responses API final-response usage only; prompts and responses are not retained; local inference cost is $0)
Unsloth Studio Unsloth Studio $UNSLOTH_STUDIO_HOME/studio.db (fallback: ~/.unsloth/studio/studio.db; exact internal-chat and authenticated API inference usage; message content is not read; training metrics are excluded; local inference cost is $0)
Hindsight Hindsight $HINDSIGHT_HOME/usage/*.jsonl (fallback: ~/.hindsight/usage/*.jsonl; populated via tokscale hindsight sync)
Jcode Jcode ~/.jcode/sessions/session_*.json + session_*.journal.jsonl sidecars (override via JCODE_HOME)
MiMo Code MiMo Code ~/.local/share/mimocode/mimocode.db (XDG data dir; SQLite)
Junie Junie ~/.junie/sessions/*/events.jsonl
Command Code Command Code ~/.commandcode/projects/**/*.jsonl (v3 transcripts persist per-request usage and cost; estimated fallback only for legacy transcripts without a usage block)
ZCode ZCode ~/.zcode/cli/db/db.sqlite (v2 usage database) and ~/.zcode/projects/**/*.jsonl (legacy transcripts)
OpenCodeReview OpenCodeReview ~/.opencodereview/sessions/**/*.jsonl
CodeBuddy CodeBuddy (CLI, IDE, VS Code plugin) ~/.codebuddy/projects/**/*.jsonl + extension logs
WorkBuddy WorkBuddy ~/.workbuddy/projects/**/*.jsonl + SQLite fallback
Devin CLI Devin CLI ~/.local/share/devin/cli/sessions.db (SQLite)
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\
Augment Code Augment Code (Auggie CLI) ~/.augment/sessions/*.json
Synthetic Synthetic Re-attributed from other sources via hf: model prefix or synthetic provider (+ Octofriend: ~/.local/share/octofriend/sqlite.db)
DeepSeek Harness DeepSeek Harness ~/.dsh/sessions/**/session.jsonl.zstd (or session.jsonl when written uncompressed; override via DSH_HOME)
MiniMax Code MiniMax Code ~/.config/tokscale/headless/mcode/*.jsonl (headless capture of mcode exec --output-format stream-json; override via TOKSCALE_HEADLESS_DIR)
Fx fx ~/.fx/sessions/<sessionId>/usage-v2.json (per-session aggregates)

Get real-time pricing calculations using 🚅 LiteLLM's pricing data, with support for tiered pricing models and cache token discounts.

Why "Tokscale"?

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.

Contents

tokscale (junhoyeo/tokscale)

Searching Database…

Что это такое?Tokscale — это консольная утилита, которая считает, сколько токенов и денег вы тратите в AI-агентах для программирования вроде Claude Code, Codex, Cursor и Gemini CLI. Сверху прилагаются дашборд и глобальный рейтинг.
Он живёт у меня в терминале или это отдельный дашборд?И то и другое: основа — это CLI и TUI, которые вы запускаете в терминале для ежедневных сводок, статистики и фильтрации, а ещё есть веб-интерфейс с 3D-графиком контрибуций и итогами «Wrapped 2025».
Как его запустить?Запускается через Bun: `bunx tokscale@latest`. Есть также вариант сборки из исходников с помощью Cargo и Bun, а в репозитории лежат файлы Docker и Compose.
Какие кодинг-агенты он вообще отслеживает?Десятки: Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor IDE, GitHub Copilot CLI, Amp, Droid, Hermes Agent, OpenClaw и многие другие — он читает локальные файлы сессий каждой утилиты, например ~/.claude/projects/ или ~/.codex/sessions/.
Все агенты работают сразу или некоторым нужна дополнительная настройка?Большинство данных читаются прямо с диска, но некоторым сначала нужна синхронизация или экспорт — Cursor IDE использует экспорт через API с автологином в десктопном приложении или вставкой cookie, а клиенты вроде Google Antigravity, Trae и Warp кэшируют данные специальными командами синхронизации.
Он работает на Windows и Linux или только на macOS?На всех трёх — это кроссплатформенный CLI на Rust, и в README пути к данным для macOS, Linux и Windows описаны рядом друг с другом.
Мои данные об использовании уходят с моего компьютера?Нет, если вы сами их не публикуете: подсчёт идёт локально по файлам, которые ваши агенты и так уже создали, а единственный путь наружу — команда submit, которая выкладывает вашу статистику в публичный рейтинг.
Почему он называется Tokscale?Название отсылает к шкале Кардашёва, по которой цивилизации ранжируются по потреблению энергии, — идея автора в том, что токены стали новой энергией, поэтому Tokscale измеряет ваш путь от планетарного разработчика до галактического архитектора кода.
Что именно показывают визуализации?Ежедневные сводки и статистику по каждой платформе в терминале, а ещё веб-интерфейс с 3D-графиком вашей активности в стиле контрибуций и итогами «Wrapped 2025» о вашем годе в токенах.
Зачем нужен глобальный рейтинг?Команда `bunx tokscale@latest submit` публикует вашу статистику под публичным профилем, чтобы вы могли сравнить расход токенов с другими разработчиками; по данным проекта, уже отслежены триллионы токенов.
Creator
junhoyeo
Size
109.7 MB
Stars
5.7K
Age
10mo
Commits · 90 Days