TokStats is the phone companion to tokscale — the open-source CLI for AI usage tracking. Pair once via QR code to see gorgeous trends, calendar heatmaps, and provider mixes directly on your home screen.
One view for your entire stack — tokscale scans them all locally
// Beautiful Analytics
Get a clear, visual digest of your AI developer habits. Spot trends, compare models, and track your activity streaks with a dashboard designed for high-agency engineers.
01 — Overview
GitHub’s green squares stopped reflecting your real work the day coding agents started committing for you. What you actually do now is drive tokens across models — TokStats makes that your daily heatmap, streaks and all.
02 — Providers
Track your usage trends across Anthropic, OpenAI, Cursor, Gemini and others. Spot which models dominate your workflow and see your estimated spend distribution in clean, interactive charts.
03 — Usage
Understand your token efficiency by separating input, output, cache reads/writes, and reasoning tokens. Track your cache-hit rates, estimated cost per message, and peak days to optimize your workflow.
// AI News, filtered
A curated feed for people who live at the frontier. New products, rate-limit changes, and pricing moves — each with an AI-written “Why it matters” and a link to the source. No timeline to doomscroll.
Kilo
A 550B-parameter open-weights model, now available free for a limited time across Kilo Code’s terminal, VS Code, and JetBrains integrations.
✦ Why it matters
Frontier-class 550B open weights, tuned for agentic coding, with a 1M-token context window — at zero cost while the window is open.
65K max output tokens and a new Beta Interactions API with a default medium thinking-effort level.
✦ Why it matters
Configurable thinking effort lets you trade latency for depth per call — a direct lever on both quality and cost.
Provider update
A rolling weekly cap now sits alongside the existing 5-hour window for high-volume agent users.
✦ Why it matters
If you run agents all day, you’ll want to pace heavy jobs — TokStats’ streak and daily views show you exactly when you’re trending toward the cap.
Pricing change
Cache-read tokens drop further, rewarding workflows that reuse large system prompts and context.
✦ Why it matters
Your cache-hit rate is now worth even more. The Usage screen surfaces it so you can see the savings land.
// Pairing
No web form, no copy-pasting API keys onto your phone. tokscale already lives on your machine — TokStats just reads from it after a one-time, device-to-device handshake.
tokscale scans your machine for every AI coding agent you use — locally.
$ npx tokscale@latest
✔ scanned 14 agents · 1.9B tokens · $1,422.63One command renders a QR that encodes your token and username — nothing else.
$ npx tokscale@latest qrscan with TokStats → {"token":"tt_••••","username":"…"}
Point your phone at the terminal. Your full history syncs in seconds — and stays in sync.
Synced 1m ago
Device-to-device. Your token is read straight from the screen — it never travels through a browser, form, or our servers.
// Standing on tokscale
TokStats is the mobile companion to tokscale — a high-performance CLI and visualization dashboard for tracking token usage and cost across AI coding agents. The name nods to the Kardashev scale: tokens are the new energy. tokscale collects everything locally on your machine; TokStats gives those numbers a home screen.
tokscale is © Junho Yeo, MIT-licensed. TokStats is an independent companion app.
┌─ OVERVIEW ───────────────────────────┐
total tokens 1.9B
total cost $1,422.63
active days 123 / 127
cur. streak 55 days
├─ SPEND MIX ──────────────────────────┤
anthropic ████████ 37%
cursor █████████ 40%
gemini ▌ 2.9%
├─ TOKENS ─────────────────────────────┤
input · output · cache 90% · reasoning
└──────────────────────────────────────┘
$ npx tokscale@latest qr # pair your phone// Early access
We’re running a closed beta on Android now, with an iOS TestFlight round next. Leave your email and we’ll send a single invite when your platform opens.
// Questions
Yes. tokscale collects your usage locally on your own machine, and your machine stays the source of truth. You decide what to sync to TokStats — your prompts and code are never read.
Think of TokStats as a fitness tracker, not a tax audit. Due to network timeouts, local caching variations, and model update overrides, some tokens might be estimated or omitted. It is built to give you a beautiful, high-fidelity view of your overall trends and usage habits, rather than a perfect accounting statement.
TokStats is a companion app, so the CLI is what gathers your numbers. Install it with npx tokscale@latest, run npx tokscale@latest qr, and scan. That’s the whole setup.
Everything tokscale scans — 25+ agents including Claude Code, Cursor, Codex CLI, Gemini CLI, Copilot, OpenCode, Kilo, Zed, Warp, Amp, Kimi, Qwen, and more. New ones land in the CLI and show up in the app.
npx tokscale@latest qr renders your saved API token and username as a QR code on your terminal. TokStats reads it directly from the screen — the credential never passes through a browser or our servers.
Android closed testing is live now via Google Play; iOS follows on TestFlight. Join the beta above and we’ll send one invite when your platform is ready.
The core — tokscale — is MIT-licensed and built by Junho Yeo. You can read every line at github.com/junhoyeo/tokscale.