tokenstat
tokenstat

Desktop workspace and usage tracker

A desktop workspace for coding agents

Run Claude Code, Codex, and other agents beside your files and Git diffs. Review their changes and track usage across your coding tools, including sessions started outside tokenstat.

See all downloads · Source on GitHub

Windows desktop is a review build. Linux desktop is planned. The iPhone and Android apps are available.

Local workspaces, usage tracking, and the CLI are free. No tokenstat account required. Your agents use their own subscriptions or API credentials.

Agent sessionRun a coding agent beside your project files and Git history.
HistoryReview file changes before choosing what to commit.
InsightsCompare usage across tools, models, and projects.

Desktop screenshots from v1.0.5 · 14 September 2026. Take the desktop tour →

Usage tracking across 18 coding tools

Compatibility and setup
  • Claude Code
  • Codex
  • Grok Build
  • OpenCode
  • Cline
  • OpenClaw
  • Muse
  • Devin CLI
  • Kimi Code
  • Qwen Code
  • Pi
  • DeepSeek Harness
  • Zed
  • Copilot CLI
  • Antigravity CLI
  • Cursor
  • Hermes Agent
  • Kilo Code

Start with a project

Your projects, agents, and usage in one app

Add an existing folder, choose an installed agent, and start a session. Keep its terminal beside your files and Git history while it works.

Run agents in your project

Launch an agent in the folder you choose. Keep several sessions open and see which are running or waiting for you.

Start a workspace →

Review what changed

Read file diffs and Git history beside the session. Edit files, choose what to stage, and commit from the app.

Review files and changes →

Understand your usage

Compare tools, projects, and models in one report. The dollar figure is the published API price, including work your subscription already covered.

Explore usage reports →

Queue tasks and schedule jobs

Keep unfinished work on a task board. Schedule recurring jobs, or connect agent and command steps into a workflow with approval points.

Tasks, automations, and workflows →

Reach your other machines

Open a project or a terminal on your Mac or server from another device. That connection is a paid plan. Watching or controlling the screen is the top plan.

Remote work and setup →

Use reports from a terminal or agent

The command line reads the same usage record as the app and can export CSV or JSON. An agent on that computer can look up projects, tasks, and usage through MCP.

CLI and MCP tools →

Dollar amounts are the published API price for those tokens, so you can compare models and tools. Work your subscription already covered is not an extra bill. How to read the numbers →

Remote work · iPhone, iPad, and Android

Reach your machines and agents from your phone

Check an agent running on your Mac or server, answer its question, and inspect its files. That computer keeps doing the work while you use your phone. See the tour →

Synced usage on the phone is included with Free. Opening a live session needs Patron or Legend, and the computer running the agent has to be on and has to approve your phone. Watching or controlling the screen is Legend. Compare plans →

tokenstat on iPhone: livetokenstat on iPhone: livetokenstat on iPhone: workspacetokenstat on iPhone: workspacetokenstat on iPhone: chattokenstat on iPhone: chat

Your data

See where your data goes

Local reports need no account. Usage sync and remote access are separate connections you can enable.

Local by default

On your machine

Your workspaceFiles, terminals, and agent conversations
Your usage archiveToken counts, models, projects, and sessions

Conversation text stays out of the usage archive. Workspace features read it separately.

What the app reads
When you enable usage sync

Your tokenstat account

Daily totalsTools and modelsOne-way project ids

Combine usage across devices. Prompts, code, folder names, and paths stay on your computer. The upload carries a one-way project id instead.

What sync sends
When you approve remote access

Your other devices

End-to-end encrypted connection

Open files, terminals, or a screen remotely. That computer approves each device. Screen access needs its own permission.

How device access works

Agents, updates, and vendor lookups use their own connections.Read the connection details

Command line

See your usage from the terminal

Use the CLI on macOS, Linux, or Windows. Scan existing usage records, explore the report, or export CSV and JSON. On the same machine, the desktop app and CLI read the same usage archive.

Install, then run tokenstat

Setup scans your records and enables hourly collection and automatic updates. Linking an account is optional.

Install options → · CLI commands → · Connect an agent through MCP →

$ curl -fsSL https://tokenstat.ai/install.sh | bash
tokenstat.ai
Headline
SessionsRequestsInput + outputActive days1,09252,604145.6M43
cache read 6.97B · cache write 189.3M · 7.30B total tokens, including cache
2026-06-17 to 2026-07-29 · peak hour 19:00
busiest 2026-07-25 (553.1M) · streak 43 days, best 43
Modelinputoutputcachetotalpriceclaude-opus-4-84.2M41.2M2.29B2.38B$257832.6%claude-fable-52.1M26.5M1.58B1.64B$354822.5%claude-opus-581.6k6.8M1.18B1.21B$92216.5%claude-sonnet-5868.8k9.2M1.11B1.17B$45816.1%cursor-grok-4.5-high-fast25.7M3.1M363.7M392.5M+$2525.4%claude-sonnet-4-6209.8k3.1M131.0M147.3M$1362.0%claude-haiku-4-5-202510011.1M677.6k105.6M123.3M$351.7%claude-opus-4-5-202511011.3M217.6k60.4M66.0M$670.9%grok-4.53.8M708.8k60.7M65.2M+$420.9%

Example usage report. Dollar amounts are the published API price. Work your subscription already covered is not an extra bill.

Optional account

Your usage across devices

Link an account to combine usage from your devices. Publish a profile if you choose, or keep it private. Paid plans add remote access and other hosted features. Local workspaces and usage reports work without an account.

Portrait of György

Made by György

I run several coding agents at once and wanted their project files, sessions, and usage in one app. I built tokenstat to work with them on my Mac and check in from my phone.

More about who makes tokenstat →

Get started

Open your first project in tokenstat

Download the Mac app, add a project folder, and choose an installed agent. Local workspaces and usage reports are free.

See all downloads · Source on GitHub

Windows desktop is a review build. Linux desktop is planned. The iPhone and Android apps are available.

All downloads and requirements →