tokenstat
tokenstat

Desktop workspace and usage tracker

A desktop workspace for coding agents

Run Claude Code, Codex, Grok Build, and other agents beside your project files, terminals, and Git diffs. Queue tasks, schedule jobs, and reach your Mac or server from another device. Track tokens, models, and estimated API value across your coding tools, including sessions you started outside tokenstat.

CLI for macOS, Linux, and Windows · Source on GitHub

Windows desktop is in development preview. Linux desktop is planned. The iPhone app is available, and android is planned.

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.
SSHOpen a terminal on your server without leaving the app.

Desktop screenshots from v0.8.0 · 3 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. See token totals and estimated API value, including usage covered by subscriptions.

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 terminal on your Mac or server from another device. Hosted remote management starts at Patron. Screen viewing and control require Legend.

Remote work and host setup →

Use reports from a terminal or agent

The CLI reads the same local usage archive as the app and exports CSV or JSON. MCP lets an agent query usage, discover workspaces, save tasks and notes, and manage jobs.

CLI and MCP tools →

Subscription-covered usage is shown at its estimated API list price. That value is separate from your subscription charge and metered API spend. How to read the numbers →

Remote work · iPhone and iPad

Reach your machines and agents from your phone

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

The host must be awake and reachable, with your device approved. Remote management requires Patron or Legend. Screen viewing and control require Legend. Compare plans →

Download on the App StoreGoogle PlayPlanned
tokenstat on iPhone: hometokenstat on iPhone: chattokenstat on iPhone: live

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 modelsHashed project keys

Combine usage across devices. Prompts, code, and project paths are excluded from this upload.

What sync sends
When you approve remote access

Your other devices

End-to-end encrypted connection

Open files, terminals, or a screen remotely. The host 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 days~534127,096446.7M89
cache read 26.49B · cache write 371.9M · 27.31B total tokens, including cache
2026-06-17 to 2026-09-13 · peak hour not collected
busiest 2026-08-06 (1.07B) · streak 89 days, best 89
Modelinputoutputcachetotalpriceclaude-opus-5136.3k20.9M8.68B8.7B$5,35831.9%claude-opus-4-82M19.4M4.26B4.28B$3,11115.7%deepseek-v4-flash15.4M8.4M2.96B2.98B$4610.9%claude-fable-5706.4k9.3M1.61B1.62B$2,4795.9%grok-4.675.5M9.4M1.27B1.35B$8414.9%claude-sonnet-5685.5k8.1M1.19B1.2B$4524.4%gpt-6-astra17M3.3M978.5M998.7M$1,3113.7%muse-spark-1.3-contributor-free42M2.2M739.6M783.9M$62.9%gpt-5.6-sol19.6M1.9M722.7M744.2M$5682.7%

Example usage report. Amounts show estimated API list-rate value. Subscription-covered usage is not an additional 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.

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.

CLI for macOS, Linux, and Windows · Source on GitHub

Windows desktop is in development preview. Linux desktop is planned. The iPhone app is available, and android is planned.

All downloads and requirements →