Tokscale CLI
tokscale
A CLI with an interactive TUI that tracks token usage and cost across AI coding agents: Claude Code, Codex, Copilot, Cursor and more
- 5,844 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Runs an npm package with a native Rust module that parses history files of a dozen agents
- After GitHub login the submit command sends usage stats to the public tokscale.ai leaderboard
Install
- Works in
Manual install
npx tokscale@latestRuns without installing, gives the full interactive TUI.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs an npm package with a native Rust module that parses history files of a dozen agents
- After GitHub login the submit command sends usage stats to the public tokscale.ai leaderboard
This is third-party code. Review the repository files before installing.
What it does
Tokscale scans the local logs and history files of AI coding agents on the machine and compiles token-usage and cost statistics by model, date and project. It shows the data in a tabbed terminal interface and supports over a dozen agents and harnesses, including Claude Code, Codex, Copilot CLI, Cursor, Gemini CLI, Amp and Warp. A Rust core handles fast parallel file parsing; the tool itself ships as an npm package.
Who it is for. For developers and leads who want visibility into how many tokens and how much money different AI agents are burning.
Good fit when
- You need to see how many tokens Claude Code, Codex or another agent spent per day or project
- You need to compare spend across different models and agents
- You need a quick terminal dashboard without setting up an external service
Not a fit when
- You need org-level billing and limits, not personal statistics
- The agent you use is not on the supported list
Example request
Show me via tokscale how many tokens Claude Code used this weekLimitations
Data comes from parsing local logs of specific agents on the machine, so accuracy depends on what and how those agents write to their history files. The native Rust module ships with the npm package; building from source is only needed for development.
How to disable. Nothing installs permanently: the npx tokscale@latest command leaves nothing resident besides the npx cache.
FAQ
Do I need to install it?
No, npx tokscale@latest downloads and runs the current version without a permanent install.
Where does the data go?
The tool reads local agent history files on the same machine to compute the statistics.
Discussion
No questions or reviews yet.
Related
CLI toolsToken and cost reports across Claude Code, Gemini CLI, Codex and Cursor in one view, built from local logs with no keys.
Token Monitor
token-monitor
A desktop widget for tracking tokens, cost and limits across 43 or more tools: Claude Code, Codex, Cursor, OpenRouter and others, for Windows and macOS
An htop-like terminal panel for AI agents: Claude Code, Codex, OpenCode and Devin sessions, CPU, tokens and cost.
A local dashboard for Claude Code, Codex CLI, Gemini CLI, Copilot and OpenCode that shows tokens, cost, latency and errors
Token Optimizer
token-optimizer
A plugin for Claude Code and Codex: trims wasted tokens, keeps work alive across sessions and compactions and shows cost. The license is noncommercial
Shows what Claude Code and Codex actually send to the API: it captures local traffic and splits tokens and cost by source
README in short
The README describes tokscale as a high-performance CLI and dashboard for tracking tokens across AI coding agents. It highlights a native Rust core for fast parallel file scanning and SIMD JSON parsing. The tokscale npm package is an alias that installs @tokscale/cli together with the bundled @tokscale/core. Running via npx or bunx without a permanent install is recommended; the TUI opens with tabs for models, reports and history import.