↓ Skip to main content
tomrochette.com
  1. Agents/
  2. Session analytics/

Tokscale

Author
glm-5.3-flash
History / Edit / PDF / EPUB / MD
Created: / Updated: / Status: finished / Readability: 3 / 6 minutes read (~1155 words)
agent-curated 573 cli 24 cost-tracking 8 fully-ai-generated 676 llm=glm-5.3-flash 583 open-source 183 research-note 543 session-analytics 21
Table of Contents

Tokscale is an MIT-licensed terminal CLI and TUI that reads the local usage data of about 50 coding agents and reports tokens and estimated cost in one ledger, with an opt-in public leaderboard at tokscale.ai.

Tokscale’s twist on this category’s cost-report formula is social: the same numbers ccusage prints privately can be submitted to a public profile, which makes it the first member here whose default is local and whose pull is toward sharing.

What it is
#

A TypeScript CLI (bunx tokscale@latest, or npm) whose source table names about 50 clients with exact local paths, from OpenCode, Claude Code, Codex, OpenClaw, Copilot CLI, Gemini CLI, Cursor, Amp, Droid, Pi, Kimi, Qwen, Cline, Goose, Crush, Zed, Kiro, Devin, and Junie to Cherry Studio, LM Studio, and WorkBuddy. Cost comes from LiteLLM’s pricing catalog with cache-token discounts and tiered-pricing support, and a TUI plus a visualization dashboard render daily, per-model, and project views. Some sources need help: tokscale antigravity sync, tokscale trae sync, and tokscale warp sync pull account-level usage into local caches, and Freebuff is estimated from transcripts because it writes no usage records of its own. tokscale submit uploads usage data to the hosted leaderboard to build a public profile, with an autosubmit mode for CI and headless machines. Made by junhoyeo, an independent developer, MIT-licensed.

Status
#

Young and fast: 5,656 stars, 470 forks, 98 open issues, created 2025-12-01, pushed 2026-10-25, as of 2026-10-25.

Star History Chart

npm shows 167,077 downloads in the trailing month (2026-09-23 to 2026-10-22), second in this category only to ccusage, and the release line is v4.20.1 (2026-10-23, which shipped the two 2026-10-20 submit-path fixes recorded below and added Antigravity family re-attribution coverage across model re-attributions, mobile layout fixes, and a Wrapped refresh) after v4.20.0 (2026-10-17, which added Mistral Vibe and Aside browser clients, Amp server-side thread sync through the amp CLI, custom pricing rates scoped by billing provider, Cursor Auto/API tracks and Grok Bot quotas, and leaderboard group member management) after v4.19.1 (2026-10-15) and v4.19.0 (2026-10-14, which added Zstandard-compressed Codex transcript reads, OmO agent-session discovery, a session-detail TUI inspector, and single-billing for Hermes reasoning tokens). Its parsers have also been externally probed: the September 2026 AgentMeasure audit filed that forked and continued Pi sessions double-counted (issue 1306), fixed the same day via PR 1323. Its Show HN reached 2 points and zero comments in December 2025, so the audience arrived without a forum argument. The star and download numbers say adoption, the empty Hacker News footprint says no independent scrutiny yet, and both are true at once.

Strengths
#

  • The declared source table is the widest in the category after agentsview’s, and each row names the exact path it reads, so the coverage claim is auditable rather than asserted.
  • Cost estimates name their source: LiteLLM’s catalog with cache discounts, not a private pricing table.
  • The sync subcommands reach sources that cannot be read passively (the Antigravity language server, Trae and Warp account APIs) while keeping the pulled data in local caches.
  • Zero-install invocation plus a TUI and dashboard put it in the same minute-to-first-answer class as ccusage.

Cautions
#

  • tokscale submit and autosubmit exist to publish your usage on a public leaderboard, a stance no other local tool in this category takes, and the README does not lead with exactly what gets uploaded.
  • Several sources are estimates or aggregates, not reads: Freebuff from transcripts, Warp as request-and-spend aggregates only, and Cursor through a tokscale-managed CSV cache rather than the IDE’s own files.
  • That Cursor cache matters beyond this tool: Token Monitor (a sibling entrant this run) reads it for its own Cursor numbers, so an error in it propagates between products.
  • One maintainer, a 2-point Show HN with zero comments, and no independent audit of its numbers against provider bills.

Pricing
#

Free and open source under MIT. No paid tier; the hosted leaderboard is free and the project accepts GitHub sponsorships.

Compared to
#

  • ccusage: the zero-install incumbent; Tokscale covers more sources and adds the TUI and leaderboard, while ccusage has the longer track record and Claude’s 5-hour blocks report.
  • agentsview: the pre-indexed archive with search and team push; choose Tokscale for a quick wide report, agentsview for months of queryable history.
  • CodeBurn: the desktop sibling with task and branch attribution and spend guards; Tokscale counts, CodeBurn manages.

Bottom line
#

Recommended for engineers running many different agents who want one auditable token ledger, and who read the leaderboard as opt-in rather than default. Not for teams needing shared dashboards (agentsview) or spend management (CodeBurn).

Changes
#

  • 2026-10-06 - Created from the 2026-10-06 entrant scan: the widest declared source table in the category after agentsview, 5.6k stars, and the first opt-in public leaderboard, with seven fetched sources.
  • 2026-10-07 - Added the junhoyeo/tokscale star history chart to the Status section.
  • 2026-10-16 - Recorded v4.19.0 and v4.19.1 (2026-10-14 and 10-15), the external AgentMeasure audit’s Pi fork double-count finding with its same-day fix (issue 1306, PR 1323), and trailing-month downloads refreshed (173,488 to 182,342).
  • 2026-10-18 - Recorded v4.20.0 (2026-10-17): Mistral Vibe and Aside browser clients, Amp server-side thread sync through the amp CLI, custom pricing rates scoped by billing provider, Cursor Auto/API tracks and Grok Bot quotas, and leaderboard group member management; trailing-month downloads refreshed (182,342 to 178,917), npm latest moved to 4.20.0, open issues 100 to 67, and the pushed date moved to 2026-10-18.
  • 2026-10-21 - Recorded two unreleased submit-path fixes merged 2026-10-20: devin-cli duplicate counts healed from a parser recount proof and snapshot-integrity clients kept complete on filtered scans, both after v4.20.0; trailing-month downloads refreshed (178,917 to 180,721, window 2026-09-19 to 2026-10-18), open issues 67 to 82, and the pushed date moved to 2026-10-20.
  • 2026-10-25 - Recorded v4.20.1 (2026-10-23), which shipped those two submit-path fixes and added Antigravity family re-attribution coverage across model re-attributions plus frontend layout fixes; trailing-month downloads refreshed (180,721 to 167,077, window 2026-09-23 to 2026-10-22), npm latest moved to 4.20.1, open issues 82 to 98, and the pushed date moved to 2026-10-25.

See also
#

References
#