Desktop app · macOS

Run your coding agents from one app

Open a project, start an agent, and keep its terminal beside your files and Git changes. Check usage across your tools without opening a separate dashboard for each one.

Download for macOS v1.0.1

Local workspaces, usage reports, tasks, and automations are free. Agents use their own subscriptions or API credentials.

1 · Start a project

Open a folder and choose an agent

Add your existing project folder. tokenstat opens its files and Git history in place. Choose an installed agent such as Claude Code or Codex, review its launch settings, and start a session. You can run several sessions in the same workspace.

The sidebar shows which sessions are running or waiting for input. Sessions belong to the host process, so they can survive closing a window while that host remains running. To keep a Mac available after quitting the app, enable Always-on host and keep it awake.

tokenstat Workspaces screen — WorkspacesProject folders, sessions, and agent launch settings.

tokenstat Agent session screen — Agent sessionAn agent working beside the commit history.

tokenstat Browser screen — BrowserYour pages and the docs, inside the app.

Add a workspace and launch your first session →

2 · Review changes

Read the diff beside the session

Open changed files, edit them, and inspect the Git diff before choosing what to stage and commit. The pull-request view brings the conversation, checks, and changes into the app.

The review UI stages and commits when you ask it to. Agents and command steps can also change the repository according to their own permissions and instructions.

tokenstat Files screen — FilesAn editor beside the sessions, with the diff in the gutter.

tokenstat History screen — HistoryUncommitted changes, reviewed before you commit.

tokenstat Pull requests screen — Pull requestsReview the conversation, the checks, and the diff.

3 · Read your usage

Compare projects, tools, and models

Home shows your activity and available plan-limit readings. Insights breaks usage down by time, tool, model, and project. The app collects supported records even for sessions you started outside tokenstat.

List-rate value estimates what recorded usage would cost at API prices. It is separate from your subscription charge. Subscription-covered usage and metered API spend are shown separately. Missing or derived readings carry their own labels.

tokenstat Home screen — HomeHeatmap, plan limits, and today at a glance.

tokenstat Insights screen — InsightsDaily volume, top models, and value at list rates.

Plan limits depend on the tool and available credentials. You can separately enable sharing of plan-limit readings with your signed-in devices. Read about plan limits →

Scheduled scans preserve usage counters before a coding tool removes its source records. Claude Code normally removes transcripts after 30 days. Some older totals can be recovered from its rollup, with less detail. tokenstat doctor reports archive coverage and reconciliation.

Tasks and scheduled work

Save a task, repeat a job, or connect several steps

Tasks

Keep unfinished work on a board and delegate a task to an agent.

Automations

Schedule a recurring job with its run limits. Review the output and status of each run.

Workflows

Connect agent steps, shell commands, HTTP calls, and approval steps. For example, run a check, have an agent review its output, and pause for a person before continuing.

tokenstat Tasks screen — TasksA board where a card is a job an agent can run.

tokenstat Automations screen — AutomationsScheduled jobs, their limits, and what each run did.

tokenstat Workflows screen — WorkflowsAgents, commands and approvals wired into one graph.

Jobs need their host running. An agent or HTTP step may incur provider charges. Agents can also manage jobs through MCP →

Other machines

Work on a Mac or server from this window

Connect to a host to open its project folders, start or resume terminals, and forward a port to a development server. SSH connections are also available from the app. From iPhone or iPad, you can check the same running work.

Account-based remote management requires Patron or Legend. Screen viewing and control require Legend and separate per-device approval. The host must be awake and reachable.

tokenstat SSH screen — SSHA real terminal on any machine, beside the rest.

Set up an always-on host → · Screen access → · Compare plans →

Requirements and availability

Platform or requirement	Detail
macOS	macOS 14 or newer, Apple silicon or Intel. Signed and notarized download.
Account	Optional for local work. Required for account sync and hosted remote management.
Agents	Use the coding tools you have installed and their own subscriptions or API credentials.
CLI	Included engine. No separate CLI installation required for the Mac app.
Windows desktop	Development preview. The Windows CLI is a stable download.
Linux	CLI and always-on host available. Desktop app planned.
iPhone and iPad	Available on the App Store. Android is planned.

Screenshots from v0.8.0 · 3 September 2026, available in light and dark themes.

Download tokenstatStable downloads, previews, and install options.Set up the Mac appInstall, add a folder, and read your first report.Use your phoneCheck and respond to work on a connected host.Check your toolsUsage collection, launch support, and setup.