What is pi ACP in Glueprint?
pi-acp is an MIT-licensed ACP adapter that bridges the pi coding agent with ACP-compliant clients such as the Zed editor. Written in TypeScript for Node.js 22 or later, it speaks ACP JSON-RPC 2.0 over stdio and spawns pi --mode rpc. It delegates model choice to the underlying pi agent and adds streaming output, tool execution mapping, session persistence across editor restarts, slash commands, and structured diffs for code edits.
ACP adapter for pi coding agent.
pi ACP connects over the open Agent Client Protocol. One generic adapter implements the protocol's client side, so pi ACP gets the same surfaces as every other harness.
Everything below works with the pi ACP CLI you have today — no migration, no new account for the model, no lock-in. Uninstall Glueprint and your terminal workflow is exactly as it was.
Set up pi ACP on a host.
Installation is host-specific: repeat these steps anywhere this agent should execute. Portal and mobile can control the session afterward, but the process remains on that host.
Open the ACP catalog
On each execution host, open Settings -> Agents -> Browse ACP catalog and choose pi ACP.
Install and initialize
Glueprint installs the registry distribution for pi ACP, starts it, and completes the ACP initialize handshake.
Start a project session
Choose pi ACP from a project or worktree and use the capabilities reported by that installed build.
How the connection works.
Glueprint adds orchestration and shared surfaces without taking ownership of the coding agent or its provider account.
Glueprint finds the pi ACP binary you installed and spawns it, then speaks the Agent Client Protocol — JSON-RPC 2.0 over stdio — to drive it. Same CLI, same authentication; Glueprint just wraps the session.
Message chunks, tool calls, and tool-call updates from pi ACP arrive as protocol notifications and render as the same live, typed timeline every Glueprint session gets — watchable from desktop, browser, or phone.
When pi ACP asks to write a file or run a command, the protocol's permission request surfaces as an inline approval card on whatever device you're holding. Approve, deny, or auto-allow per tool.
Because pi ACP speaks ACP, adding it is a catalog entry, not an engineering project — the same adapter runs every other agent in the registry, so you can tile them side by side.
Capabilities and discovery.
The status labels separate guaranteed integration behavior from features owned or announced by the installed agent.
| Capability | Status | Behavior |
|---|---|---|
| MIT-licensed ACP adapter for the pi agent | Runtime | Confirmed when the installed agent connects. |
| ACP JSON-RPC 2.0 over stdio | Runtime | Confirmed when the installed agent connects. |
| Session persistence across editor restarts | Runtime | Confirmed when the installed agent connects. |
| Structured diffs for code modifications | Runtime | Confirmed when the installed agent connects. |
| File-based, built-in, and skill-based slash commands | Runtime | Confirmed when the installed agent connects. |
Authentication, ownership, and limits.
Glueprint is the environment around the agent. Credentials, model access, and vendor-specific behavior stay where their owner designed them.
Watch every pi ACP prompt, tool call, and diff stream in real time — desktop, web portal, iOS and Android. The session runs on your machine; the view follows you.
Permission prompts arrive as approval cards wherever you are. Kick off a refactor at your desk, approve the file writes from the couch.
Run several pi ACP sessions side by side, each in its own git worktree, with diffs, history, and a three-pane conflict resolver alongside.
Tile pi ACP next to Claude Code, Codex, and the rest of the ACP fleet in the Command Center. The protocol differs; the surface doesn't.
Promote it to an assistant: persona, constitution, long-term memory, and a daily journal on disk, loaded into every wake.
Wake it on cron: triage the inbox every 30 minutes, sweep PRs at 9am, run the nightly cleanup. Quiet hours and watermarks prevent re-fires.
Messages, sessions, and output tokens computed from session logs — compare pi ACP against Claude Code, Codex, and your other ACP agents.
Remote viewing rides AES-256-GCM envelope encryption. The relay routes; it cannot read.
Common questions
Can I run pi ACP with Glueprint?
Yes. pi ACP is registered in the official Agent Client Protocol registry, and Glueprint implements the protocol's client side. It spawns the pi ACP CLI you already installed and drives it over JSON-RPC 2.0 — adding live sessions, inline approvals, worktrees, and remote control.
Do I need a separate pi ACP subscription or API key?
No. Glueprint doesn't resell model access. pi ACP authenticates exactly the way its vendor designed — its own login, subscription, or API key. Glueprint spawns the binary and speaks the protocol; it doesn't sit between you and the model provider.
Can I run pi ACP from my phone?
Sessions always run on your machines — a laptop, a desktop, or a server with the headless daemon. The iOS and Android app streams pi ACP sessions live, lets you send follow-ups, and handles permission approvals from anywhere.
Can I run pi ACP next to Claude Code and Codex?
Yes — that's the point. Each harness is an adapter; sessions from all of them tile into the same Command Center, share the same task boards, and roll up in the same per-harness analytics.
Is my session content private?
Yes. Remote viewing routes AES-256-GCM-encrypted envelopes through the relay, which stores a wrapped key it cannot open — decryption happens on your devices. On the free local tier, session content never leaves your machine at all. See security.