# Harness Dashboard

> Token usage across your AI coding tools, in one local app.

Harness Dashboard is a local desktop app that reads the sessions your AI coding tools already write to disk and shows where your tokens and money go.

## What does Harness Dashboard do?

- **Overall usage.** Tokens, API-equivalent cost, sessions, prompts and cache hit rate, compared with the previous period.
- **Per-prompt cost.** What each request really consumed, call by call, including the subagents it spawned.
- **Who used what.** Where the money goes from tool to model to project in one flow chart, with a network of what used what.
- **Branches.** What each piece of work cost, per git branch, with its sessions, changed files, commits and pull requests.
- **Live view.** Tokens per minute as you work, the sessions running now, and how much of your plan limits is left.
- **Budgets and alerts.** Daily, monthly and per-project spending caps, with desktop notifications at 80% and 100%.
- **Model drift and tips.** Whether a model got slower, clumsier or more error-prone than usual, plus rule-based tips from your own usage.
- **MCP server.** Agents in Claude Code, Codex, Cursor, Zed or OpenCode can read your usage, budgets and plan limits themselves.

## Which harnesses and tools does Harness Dashboard support?

| Harness | Support |
| --- | --- |
| Claude Code | Reads ~/.claude/projects/**/*.jsonl. |
| Codex | Reads ~/.codex/sessions/** and archived_sessions/**. |
| Gemini CLI | Reads ~/.gemini/tmp/<project>/chats/. |
| GitHub Copilot CLI | Reads ~/.copilot/session-state/ and session-store.db. |
| GitHub Copilot Chat in VS Code | Reads the chat session files of VS Code, with no setup. |
| OpenCode | Reads its SQLite database, opencode.db, read-only. |
| pi | Reads ~/.pi/agent/sessions/**/*.jsonl. |
| omp (oh-my-pi) | Reads ~/.omp/agent/sessions/**/*.jsonl. |
| Zed | Reads the threads database of Zed’s own agent. |
| Cline | Reads task folders in VS Code’s extension storage. |
| Roo Code | Reads task folders in VS Code’s extension storage. |
| Kilo Code | Reads task folders in VS Code’s extension storage. |
| Cursor | Usage from cursor.com (Sync Cursor usage, off by default) or its CSV export. |

## Which platforms does Harness Dashboard run on?

- macOS
- Linux (x86_64)
- Windows

## How do I install Harness Dashboard?

### macOS and Linux

```sh
curl -fsSL https://raw.githubusercontent.com/MSpiechowicz/harness-useful-dashboard/main/install.sh | sh
```

### Windows (PowerShell)

```powershell
powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/MSpiechowicz/harness-useful-dashboard/main/install.ps1 | iex"
```

## Is Harness Dashboard private? Where does my data live?

- Everything runs locally. Your usage is never uploaded anywhere.
- Usage is stored in a local SQLite database, readable by your account only.
- The server and its API listen only on 127.0.0.1.
- Prompt text is stored truncated to 2,000 characters, and API keys, tokens and private keys in it are replaced with [redacted]. Set Stored prompt length to 0 to keep no prompt text.
- Outbound requests never carry your usage: the optional update check, plan-limit checks while Live is open, and the optional Cursor sync. All can be switched off in Settings.

## Frequently asked questions

### What is Harness Dashboard?

Harness Dashboard is a local desktop app that reads the sessions your AI coding tools already write to disk. It stores everything in a local SQLite database and shows interactive charts of where your tokens and money go, by project, model, session and prompt.

### Which coding tools does Harness Dashboard read?

Claude Code, Codex, Gemini CLI, GitHub Copilot CLI, GitHub Copilot Chat in VS Code, OpenCode, pi, omp, Zed, and the Cline, Roo Code and Kilo Code extensions. It also reads Cursor usage from cursor.com or a CSV export. That is 13 tools.

### How do I install Harness Dashboard?

On macOS and Linux run the curl install script from the README. On Windows run the PowerShell command. The installer verifies the release checksums. You can also download a deb, rpm, dmg or msi from the GitHub releases page.

### Does Harness Dashboard upload my usage?

No. Everything runs locally and your usage is never uploaded. The app makes only a few outbound requests, such as the optional update check and plan-limit checks, and none of them sends your usage. Each can be switched off in Settings.

### Where does Harness Dashboard keep its data?

In a local SQLite database on your machine, or wherever you point it. The app data folder is readable by your account only. You can even point several machines at one SQLite file on iCloud Drive, Dropbox, OneDrive or a network share.

### Can my agent read Harness Dashboard data?

Yes. harness-dashboard mcp is a local MCP server over stdio. An agent can check what a session or branch cost, how a budget stands or how much of a plan limit is left, for example before a large refactor. It reads the database only.

### Is Harness Dashboard free and open source?

Yes. Harness Dashboard is open source under the GPL-3.0-or-later license. Its costs are API-equivalent prices in USD, not a bill.

## Links

- Page: https://harness-useful.com/dashboard
- GitHub: https://github.com/MSpiechowicz/harness-useful-dashboard
- Releases: https://github.com/MSpiechowicz/harness-useful-dashboard/releases
- License: GPL-3.0-or-later
- Harness Useful home: https://harness-useful.com/
- FAQ: https://harness-useful.com/faq