# tokenstat > Run coding agents in project workspaces, review their changes, and track usage across tools. Available for Mac, with a CLI and iPhone app. ## Pages - [Home](https://tokenstat.ai/) - [Privacy](https://tokenstat.ai/privacy) - [Terms](https://tokenstat.ai/terms) - [Download](https://tokenstat.ai/download): the desktop app and the CLI - [Desktop app](https://tokenstat.ai/desktop): run agent sessions and watch what they cost - [Command line](https://tokenstat.ai/cli): the whole engine in one binary - [Mobile app](https://tokenstat.ai/mobile): reach every machine, attach to a live session - [MCP server](https://tokenstat.ai/mcp): 49 tools for usage, workspaces, tasks, notes, automations and workflows over stdio; setup and copyable agent instructions - [Models](https://tokenstat.ai/models): multi-source API list rates - [Providers](https://tokenstat.ai/providers): curated labs and routers - [Plans](https://tokenstat.ai/plans): subscription sticker prices - [Benchmarks](https://tokenstat.ai/benchmarks): Arena + AA scores - [Compare](https://tokenstat.ai/compare): side-by-side rates - [Calculator](https://tokenstat.ai/calculator): list-rate usage shape - [Pricing](https://tokenstat.ai/pricing): product tiers - [Stats](https://tokenstat.ai/stats): platform totals - [Changelog](https://tokenstat.ai/changelog): release history Every guide is available as markdown by appending `.md` to its URL. ## Help ### Getting started - [What tokenstat counts, and how to read the numbers](https://tokenstat.ai/help/what-tokenstat-counts.md): Token totals, estimated API value, subscription coverage, and confidence labels explained, with links to source-specific limits. - [What tokenstat reads, stores, and connects to](https://tokenstat.ai/help/is-tokenstat-safe.md): Usage collection, workspace content, vendor credentials, and remote connections have different data boundaries. Here is what each feature handles. - [Install the tokenstat CLI on macOS, Linux, or Windows](https://tokenstat.ai/help/install-tokenstat.md): Install commands, setup defaults, hourly collection, automatic updates, and options for local-only use. - [Uninstall tokenstat](https://tokenstat.ai/help/uninstall-tokenstat.md): One line to remove the schedule and the binary, one flag to delete your archive too, and the manual steps if you would rather do it by hand. Nothing is left be… ### Desktop app - [Set up the tokenstat desktop app](https://tokenstat.ai/help/desktop-app.md): Install the Mac app, add a project folder, launch an agent, and find your usage reports. Local work needs no tokenstat account. - [Run agent sessions in a workspace](https://tokenstat.ai/help/workspaces-and-agent-sessions.md): A workspace is a folder with a file tree, a git history, and a session launcher. Here is how to add one, start an agent in it, run several at once, and review… - [Plan limits on your dashboard](https://tokenstat.ai/help/plan-limits-on-your-dashboard.md): The app can tell your account how much of each plan window you have used, so the website shows the same figure as the window on your desk. What travels is a pe… - [Keep a Mac or Linux host available for remote work](https://tokenstat.ai/help/always-on-host.md): Install the host, keep it running, approve devices, and troubleshoot remote access from another computer or phone. - [Set up remote screen access](https://tokenstat.ai/help/remote-screen-access.md): The checks, permissions, and per-device approval needed to view or control another screen. - [Encrypted SSH vault and recovery](https://tokenstat.ai/help/encrypted-ssh-vault.md): How tokenstat syncs SSH hosts, keys, and snippets without receiving the keys needed to read them. ### CLI and MCP - [Which tokenstat command shows what](https://tokenstat.ai/help/which-command-shows-what.md): One archive, a dozen views over it. Which command answers which question, the four filters that work on all of them, and why every report can be piped as JSON. - [Set a budget and put usage in your prompt](https://tokenstat.ai/help/set-a-budget-and-a-statusline.md): Two commands built for glancing rather than reading: a soft list-rate cap you can check at any time, and a single line you can hang off your shell prompt witho… - [Connect an agent to workspaces, tasks and notes with MCP](https://tokenstat.ai/help/run-tokenstat-from-an-agent.md): Connect tokenstat's 49 MCP tools, copy a short agent prompt, discover workspace IDs, and answer tokenstat questions from MCP. ### Reading your usage - [Why cache reads dominate your token count](https://tokenstat.ai/help/why-cache-reads-dominate-your-token-count.md): Most of your tokens are cache reads, and they cost a fraction of fresh input. That is why a raw token number tells you almost nothing, and why a big context is… - [How confident is each number, and what confidence actually means](https://tokenstat.ai/help/how-confident-is-each-number.md): Every event carries exact, strong, or derived. It is a statement about identity and double counting, not about arithmetic, and knowing the difference tells you… ### Sync and profiles - [What leaves your device when you sync usage](https://tokenstat.ai/help/what-leaves-your-machine-when-you-sync.md): The usage-sync fields, hashed project keys, schema versions, and the command to inspect a proposed upload. - [Publish a profile, or stay private](https://tokenstat.ai/help/publish-a-profile-or-stay-private.md): An account is private until you deliberately publish it. Here is what claiming a handle does, what a public profile shows, and how to go back to private withou… ### Tools and sources - [Supported tools, collection, and launch requirements](https://tokenstat.ai/help/which-tools-tokenstat-reads.md): Compare local usage collection, agent launch support, vendor connections, and plan-limit readings for supported tools. - [Cover Cursor and Antigravity, the sources that need a token](https://tokenstat.ai/help/cover-cursor-with-a-token.md): Set up Cursor usage fetches and Antigravity IDE collection, inspect authentication status, and remove a stored vendor token. ### Troubleshooting - [tokenstat found no sessions](https://tokenstat.ai/help/no-sessions-found.md): An empty report almost always means the logs are somewhere tokenstat did not look, or were never written. Here is how to tell which, in the order worth checkin… - [Why your numbers disagree with a vendor's dashboard](https://tokenstat.ai/help/numbers-disagree-with-vendor-dashboard.md): tokenstat counts a different thing from a billing page, over a different window, from a different source. Here is which differences are expected and which are… - [A device stopped syncing](https://tokenstat.ai/help/machine-stopped-syncing.md): A profile that stopped updating is usually a paused schedule, a revoked token, or a device limit. Here is how to tell which, and what to do about each.