Tokscale
A high-performance CLI tool and visualization dashboard for tracking token usage and costs across multiple AI coding agents including Claude Code, Cursor, Codex, Gemini, and more.
At a Glance
Fully free and open-source under the MIT License. Use, modify, and distribute freely.
Engagement
Available On
Listed Apr 2026
About Tokscale
Tokscale is an open-source, high-performance CLI tool and visualization dashboard for monitoring and analyzing token consumption across 20+ AI coding agents. It features a native Rust TUI powered by Ratatui, real-time pricing from LiteLLM, and a social platform with global leaderboards and public profiles. The tool supports cross-platform usage on Windows, macOS, and Linux, and can be run instantly with npx tokscale@latest or bunx tokscale@latest with zero setup.
- Interactive TUI Mode — Run
tokscaleto launch a beautiful terminal UI with 6 views (Overview, Models, Daily, Hourly, Stats, Agents), keyboard/mouse navigation, 9 color themes, and a GitHub-style contribution graph. - Multi-platform Agent Support — Tracks usage from OpenCode, Claude Code, Codex CLI, Copilot CLI, Cursor IDE, Gemini CLI, Amp, Droid, OpenClaw, Hermes Agent, Pi, Kimi CLI, Qwen CLI, Roo Code, Kilo, Mux, Kilo CLI, Crush, and Synthetic.
- Real-time Pricing — Fetches current model pricing from LiteLLM with 1-hour disk cache, automatic OpenRouter fallback, and hardcoded Cursor model pricing for newly released models.
- Native Rust Core — All parsing and aggregation is done in Rust for ~8-10x faster processing and ~45% memory reduction vs. pure TypeScript.
- Detailed Token Breakdowns — Tracks input, output, cache read/write, and reasoning tokens per model and per client.
- Flexible Filtering — Filter by platform (
--claude,--cursor,--opencode, etc.), date range (--today,--week,--since/--until), or year. - Web Visualization — Run the frontend locally for an interactive 2D/3D contribution graph with tooltips, day breakdowns, and source filtering.
- Social Platform — Login with GitHub (
tokscale login), submit usage data (tokscale submit), compete on leaderboards, and embed stats in your GitHub profile README. - Wrapped 2025 — Generate a shareable year-in-review image with top models, clients, streaks, and a contribution heatmap using
tokscale wrapped. - Export & Scripting — Output data as JSON (
--json) for automation, CI/CD pipelines, or external visualization tools.
Community Discussions
Be the first to start a conversation about Tokscale
Share your experience with Tokscale, ask questions, or help others learn from your insights.
Pricing
Open Source (MIT)
Fully free and open-source under the MIT License. Use, modify, and distribute freely.
- Interactive TUI with 6 views
- Support for 20+ AI coding agents
- Real-time pricing from LiteLLM
- Native Rust core for fast processing
- 2D and 3D contribution graph
Capabilities
Key Features
- Interactive TUI with 6 views (Overview, Models, Daily, Hourly, Stats, Agents)
- Native Rust core for ~8-10x faster processing
- Real-time pricing from LiteLLM with OpenRouter fallback
- Support for 20+ AI coding agents
- Detailed token breakdowns (input, output, cache read/write, reasoning)
- Flexible filtering by platform, date range, and year
- 2D and 3D contribution graph visualization
- Social platform with global leaderboard and public profiles
- GitHub profile embed widget and badge
- Wrapped 2025 year-in-review image generation
- JSON export for scripting and automation
- Headless mode for CI/CD pipelines
- 9 color themes
- Mouse and keyboard navigation
- Settings persistence
- Cross-platform support (Windows, macOS, Linux)
