Monaco, in the page
Open the file the agent just touched, side by side with the chat. Diff viewer, file tree, real terminal per folder.
Open source · self hosted
Every pi session mirrored to the browser as it runs. Read the transcript, answer the prompt, kill the runaway, resume it from your phone. No screen sharing, no tmux gymnastics.
Why it exists
A long agent run is mostly waiting, punctuated by one question you need to answer. PI Dashboard turns that into a glanceable list: which session is working, which one stopped, which one is blocked on you.
Sessions group by project folder. Pin the folders you care about, name the runs, and stop guessing which terminal tab holds what.
Open the file the agent just touched, side by side with the chat. Diff viewer, file tree, real terminal per folder.
Switch branch from the card. Spin up a worktree per change. Review the diff and commit without leaving.
Agent cards, live graph, budget draw-down. Pop a subagent out and read its full timeline.
Start a session on a schedule, or when a file lands. Set a goal with success criteria and let the supervisor drive.
Sign in to Anthropic, Codex, Copilot, Gemini. Swap the model mid-session. Point other tools at the built-in proxy.
Scan a QR to pair. Share over a zrok tunnel with OAuth and an allowlist. Install it as a PWA.
One POST /mcp endpoint puts every session behind an MCP tool call — Claude
Desktop, Cursor, or another pi. Bearer credential required, localhost included.
Ship procedures as skills the agent loads on the right trigger: review, debug, harden, estimate, cut a release. Browse, install and move them per folder or globally.
The UI is composed of named slots. A plugin claims one with a React component — card badge, content view, settings section, tool renderer — and ships as an npm package.
Download
Pre-built installers for macOS, Linux and Windows. Bundles Node.js and auto-installs pi + OpenSpec — you don't need any prerequisites.
Prefer a CLI install? pi package and npm options below.
Get started
Pick whichever fits your workflow. You can always switch later.
Zero prerequisites. Guided setup wizard.
# Download an installer: # github.com/BlackBeltTechnology/pi-agent-dashboard/releases # # macOS — .dmg (arm64 / x64) # Linux — .deb / .AppImage # Windows — .exe (installer) / .zip
Bundles Node.js, auto-installs pi + openspec. System tray integration. Builds are not yet code-signed — see the unblocking notes below.
Windows: SmartScreen warns on first launch. Either More info → Run anyway,
or right-click the downloaded .exe / .zip → Properties →
tick Unblock → OK before running. For ZIPs, unblock the archive before extracting.
macOS: the DMGs are not yet notarized. Either right-click PI-Dashboard.app → Open the first time, or clear the quarantine attribute:
xattr -cr /Applications/PI-Dashboard.app
If you see No such xattr: com.apple.quarantine from an older
xattr -d command, that's harmless — the attribute was never set. Just launch the app.
Already using pi? Add it as a package.
# From inside any pi session: /packages add @blackbelt-technology/pi-agent-dashboard # That's it. The dashboard auto-starts # next time you launch pi.
Classic Node.js install. Runs everywhere.
npm install -g @blackbelt-technology/pi-agent-dashboard # Start the server: pi-dashboard start # or in dev mode: pi-dashboard start --dev
Requires Node.js 20+ and a working pi installation.