Pi-Harness Adds Run Control to Pi Coding Agent
Pi-Harness wraps the Pi Coding Agent in an Electron desktop app with checkpoints, per-run budgets and agent teams, released under AGPL-3.0.
In short
Pi-Harness is an open-source Electron desktop app that adds run tracing, checkpoints, per-run budgets and multi-agent teams on top of the Pi Coding Agent without replacing the Pi runtime.
At a glance
- Pi-Harness is an Electron desktop app wrapped around the Pi Coding Agent; native Pi stays the runtime.
- Licensed AGPL-3.0-only; installers for macOS (Apple Silicon and Intel), Windows x64 and Linux x64.
- At the time of access the repository showed 997 stars, 24 forks and 165 commits.
- Building it needs Node.js 22.22.2 or newer and pnpm 9.12.1; the interface ships in eight languages, German included.
- History view reads local sessions from Claude Code, Cursor, Gemini CLI and Pi.
Pi-Harness does not try to be a better coding agent. It is a desktop shell around one: native Pi still executes the work, and the app adds the layer most agent tooling leaves out, which is seeing what a run actually did and getting back to a known-good point when it goes wrong. Everything described here comes from the project README; no independent test of these claims was available.
Watching a run, and undoing it
The observation side lists run inspection, execution tracing, replay, side-by-side comparison of two runs, and a view of token usage and cost. The recovery side lists checkpoints, resume, fork, retry, and budgets scoped to a single run. Together they answer the two questions that matter once an agent is allowed to touch a repository on its own.
Multi-agent work is handled with reusable team templates, prioritized tasks with dependencies, and review gates between steps. The gate is the notable piece: it puts a deliberate stop into a pipeline that would otherwise run to completion unattended.
What it means for an existing Pi setup
The README states that Pi sessions, configuration, tools, Skills and extensions stay compatible, and that Pi remains usable outside the desktop app. For anyone already driving Pi from a terminal, that is the deciding claim. It is also the one claim that cannot be checked without installing the app.
The app additionally browses local conversation history from other tools, naming Claude Code, Cursor, Gemini CLI and Pi itself. Browsing that history, local previews and scan retries consume no model tokens, according to the project.
Stack, license, and what is left unsaid
Pi-Harness is written in TypeScript with Vue 3 and Electron, with installers for macOS (Apple Silicon and Intel), Windows x64 and Linux x64. Building from source requires Node.js 22.22.2 or newer and pnpm 9.12.1. The interface ships in eight languages, German among them.
The license is AGPL-3.0-only, which matters if you host the tool for other people and is largely irrelevant on a personal machine. At the time of access the repository showed 997 stars, 24 forks and 165 commits. No current release tag and no explicit privacy statement were visible on the project page, so how the app treats local session data is not documented there.
The wider signal is categorical rather than technical. Supervision tooling for coding agents, meaning tracing, budgets, rollback and approval gates, is separating from the agents themselves into its own layer. A single-maintainer project approaching a thousand stars suggests the demand is real, even while the software is young and unproven in daily use.
FAQ
What is Pi-Harness?
An open-source Electron desktop app that layers observation, recovery, per-run budgets and multi-agent coordination on top of the Pi Coding Agent. The agent itself still runs on the native Pi runtime.
Does Pi-Harness replace the Pi Coding Agent?
No. The repository states that Pi sessions, configuration, tools, Skills and extensions remain compatible and that Pi stays usable outside the desktop app. That claim has not been independently verified.
Which platforms and license does Pi-Harness use?
It is AGPL-3.0-only, with installers for macOS (Apple Silicon and Intel), Windows x64 and Linux x64. Building from source requires Node.js 22.22.2 or newer and pnpm 9.12.1.