tokscale
đ°ī¸ Track token usage across AI coding agents from your terminal. đ Global leaderboard with trillions of tokens tracked.
Install / Use
npx skills add junhoyeo/tokscaleInstalls into whichever agent you are using.
CLAUDE.md
Claude Code project instructions
Quality Score
Category
AI & Machine LearningSupported Platforms
Tags
Our assessment of tokscale
tokscale scores 87/100 on our quality scale, 465th of 965 AI & Machine Learning skills we index (top 49%).
Its CLAUDE.md is 129 KB long, well organised into 238 sections with 70 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
With 5,798 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated today, so tokscale is actively maintained.
- Our last check on 2026-10-18 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit â read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the first 100 KB of the file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (2 minor notes below). An AI review of the same text found nothing harmful.
- noteInstalls by piping a downloaded script into a shellline 235
curl -fsSL https://bun.sh/install | bash - noteInstalls by piping a downloaded script into a shellline 1499
powershell -c "irm bun.sh/install.ps1 | iex"
AI review by kimi-k2.7-code on 2026-09-24. Automated pattern scan on 2026-09-24. It catches known dangerous patterns, not every risk â read a skill before letting an agent act on it.
tokscale compared with similar skills
All 4 of these similar skills score higher than tokscale; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| tokscale (this skill)by junhoyeo | 87 | 5.8k | today | CLAUDE.md |
| claude-memby thedotmack | 100 | 113.5k | today | CLAUDE.md |
| taste-skillby Leonxlnx | 100 | 110.6k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 109.2k | today | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 90.9k | 10d ago | CLAUDE.md |
Frequently asked questions
- How do I install tokscale?
- Run
npx skills add junhoyeo/tokscale. The install tabs above show the steps for each supported agent. - Which AI agents does tokscale work with?
- It is written for Claude Code, Cursor, Gemini CLI and OpenAI Codex, as a CLAUDE.md file. Other agents that read the same format can often use it too.
- Is tokscale safe to use?
- Our scan of the first 100 KB of the file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (2 minor notes below). An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is tokscale still maintained?
- The repository was last updated today, so tokscale is actively maintained.
Skill content
View source on GitHubA high-performance CLI tool and visualization dashboard for tracking token usage and costs across multiple AI coding agents.
<div align="center">[!TIP]
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. |
đēđ¸ English | đ°đˇ íęĩė´ | đ¯đĩ æĨæŦčĒ | đ¨đŗ įŽäŊ䏿
</div> <!-- </CENTERED SECTION FOR GITHUB DISPLAY> -->| 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 submitto 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/ (*/agent/openclaw-agent.sqlite + */sessions/*.jsonl; + legacy: .clawdbot, .moltbot, .moldbot) |
| <img width="48px" src=".github/assets/client-openai.jpg" alt="Codex" /> | Codex CLI | ~/.codex/sessions/ |
| <img width="48px" src="https://github.com/PrimeIntellect-ai.png" alt="Prime Agent" /> | Prime Agent | ~/.prime/agent/sessions/ and ~/.prime/agent/session-artifacts/ (RLM child sessions) |
| <img width="48px" src=".github/assets/client-sakana.png" alt="Sakana Fugu" /> | Sakana Fugu | via Codex â ~/.codex/sessions/*.jsonl (model_provider: sakana) |
| <img width="48px" src=".github/assets/client-copilot.jpg" alt="Copilot" /> | GitHub Copilot CLI | ~/.copilot/session-store.db (CLI usage events; no OTEL required), ~/.copilot/otel/*.jsonl (+ COPILOT_OTEL_FILE_EXPORTER_PATH), ~/.copilot/data.db |
| <img width="48px" src=".github/assets/client-hermes.png" alt="Hermes Agent" /> | Hermes Agent | $HERMES_HOME/state.db and $HERMES_HOME/profiles/*/state.db (fallback: ~/.hermes/...) |
| <img width="48px" src=".github/assets/client-gemini.png" alt="Gemini" /> | Gemini CLI | $GEMINI_CLI_HOME/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 CODEBUFF_DATA_DIR) |
| <img width="48px" src=".github/assets/client-freebuff.png" alt="Freebuff" /> | Freebuff | shares ~/.config/manicode/ with Codebuff (same runtime); token usage is estimated from the transcript (no local usage; override via FREEBUFF_DATA_DIR) |
| <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/ |
| <img width="48px" src="https://omp.sh/favicon-180x180.png" alt="Oh My Pi" /> | omp (Oh My Pi) | ~/.omp/agent/sessions/**/*.jsonl |
| <img width="48px" src=".github/assets/client-senpi.png" alt="Senpi" /> | Senpi (OmO Native) | ~/.senpi/agent/sessions/ (override via SENPI_CODING_AGENT_DIR) |
| <img width="48px" src="https://github.com/getkimchi.png" alt="Kimchi" /> | Kimchi Coding | ~/.config/kimchi/harness/sessions/ (override via KIMCHI_CODING_AGENT_DIR) |
| <img width="48px" src=".github/assets/client-synthetic.png" alt="Reasonix" /> | Reasonix | ~/.reasonix/stats/*.jsonl (override via REASONIX_STATE_HOME or REASONIX_HOME) |
| <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 KIMI_CODE_HOME) kimi-work: desktop app-data root (auto-discovered) |
| <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 | $XDG_DATA_HOME/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 GOOSE_PATH_ROOT) |
| <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 GEMINI_CLI_HOME; local SQLite, read directly â no antigravity sync needed) |
| <img width="48px" src=".github/assets/client-antigravity.png" alt="Antigravity IDE Extension" /> | Antigravity IDE Extension | ~/.gemini/antigravity/conversations/*.db (local SQLite, read directly) |
| <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 | $GROK_HOME/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/dat
Truncated for display â read the full file on GitHub.
Related Skills
claude-mem
113.5kPersistent Context Across Sessions for Every Agent â Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
taste-skill
110.6kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
109.2kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu â one CLI, zero API fees.
Understand-Anything
90.9kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit â see the Safety scan above for what the skill file itself contains.

