gyorgysh/tokenstat

tokenstat is a local-first CLI for the AI coding tools you already use. It reads
their local records, shows tokens, models, projects, sessions, and estimated
API value in one place, then lets you work with those machines from the desktop
app or an optional synced account.
The CLI and macOS desktop app are the stable downloads. Windows desktop, iPhone,
iPad, and Android clients are under active development and share the same core,
along with the MCP server. The website at
tokenstat.ai is a separate project. This repository is
everything that runs on your machine.
A synced profile, if you want one: tokenstat.ai/gyorgy
## Highlights
Local first. Counters stay on your machine. Conversation text never reaches the archive
CLI first. Fast local reports, JSON output, setup, scheduling, updates, and an interactive terminal UI on macOS, Linux, and Windows
macOS desktop. A signed and notarized disk image with Home, Insights, Devices, workspaces, tasks, notes, workflows, and automations
Simulator beside your chat. On Mac, attach local iPhone, iPad or Android emulators in the editor, interact with the live screen and follow devices started by your agent
Clients in development. Preview Windows desktop and Android builds exercise the shared host and archive while those platforms mature
Many sources. Claude Code, Codex, Grok, OpenCode, Cline, Antigravity, OpenClaw, Zed, Copilot CLI, Pi, Hermes Agent, Kilo Code, DeepSeek Harness, Muse, Devin CLI, plus Cursor fetch
One schema. Daily, weekly, monthly, and per-model views across every tool
MCP. Agents can ask their own spend over stdio, no hosted server
Optional sync. Sealed aggregates to tokenstat.ai/ when you link an account (live example)
One archive, one core. The terminal, the Mac, the phone and the tablet all read it.
## Charts in agent replies
Agents can present interactive charts directly in chat on Mac, Windows, iPhone,
iPad and Android. Inspect values with a pointer, touch or keyboard, toggle
series, zoom, open the data table and export an image or dataset. Rendering
works offline with the same bundled engine on every client.
The MCP tools chartcreate, chartvalidate, chartschema and chartexamples,
plus tokenstat chart and small JavaScript/Python helpers, share a versioned,
data-only format. See the chart API and examples.
## Supported sources
| Kind | Tools |
| On disk | Claude Code (with rollup recovery), Codex, Grok, OpenCode, Cline, Antigravity CLI, OpenClaw, Zed, Copilot CLI, Pi, Hermes Agent, Kilo Code, DeepSeek Harness, Muse, Devin CLI |
| Remote fetch | Cursor (keychain or pasted token, 30 minute cache) |
| IDE sync | Antigravity IDE (app open, then tokenstat fetch) |
Plan quota for Antigravity is reported separately and is never turned into fake token events.
## Architecture
crates/
tokenstat-core/ Parsing, normalization, pricing, aggregation. No network.
tokenstat-cli/ Command line front end.
tokenstat-sync/ The only crate that talks to the network.
tokenstat-mcp/ MCP server over the core facade.
tokenstat-host/ Protocol, session, dispatch, unix socket or Windows named pipe.
tokenstat-ffi/ C ABI over the host. JSON in, JSON out.
apps/
mac/ SwiftUI app (macOS, iOS, iPadOS).