Harness Dashboard

• 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.

• 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.

1. # macOS and Linux

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

2. # Windows (PowerShell)

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

Prefer a download? Every release and its notes are on the Harness Dashboard releases page.

• 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.

Harness Dashboard is the usage and cost meter in Harness Useful, a family of four open-source, local tools for coding-agent harnesses. Harness Desktop is the window, Harness Skills the workflow, Harness Memory the shared project memory and Harness Dashboard the usage and cost meter.

Each tool works on its own. Harness Desktop’s Recommended setup can install the others after you confirm each part and register their MCP servers in each detected harness.

• Harness Desktop Your coding-agent CLI, in a native desktop window.
• Harness Skills From a natural-language request to reviewed, verified work.
• Harness Memory Project memory for your AI coding agents, in one local binary.

See the Harness Useful home page, all four tools side by side or the family FAQ.