Skip to content
Agentic Control Plane

pi-acp (Agent Client Protocol) vs the ACP extension for Pi

David Crowe David Crowe · · Updated · 6 min read
pi earendil coding-agents agentic-control-plane plugin-launch extensions
Share X HN LinkedIn

pi-acp on npm (svkozak/pi-acp) is an Agent Client Protocol adapter. It lets an editor such as Zed talk to Pi over stdio. This post is about the other ACP: the Agentic Control Plane extension for Pi (@agenticcontrolplane/pi). It is one TypeScript file that checks every Pi tool call against your rules, allows, asks or denies it, and logs the decision. ACP vs ACP explains the split.

Pi is a minimal terminal coding agent from Mario Zechner (libGDX) and Armin Ronacher (Flask, Jinja). It ships no permission system, and says so. It has four tools (read, write, edit, bash), no approval prompts, no allowlist and no sandbox. Its security docs tell you to use a container if you want a boundary.

That is a design choice. The core stays tiny and everything else is an extension. So the natural way to add control to Pi is an extension, on the same events Pi’s own tools use.

Install

curl -sf https://agenticcontrolplane.com/install.sh | bash

The installer finds Pi, puts one file at ~/.pi/agent/extensions/acp.ts, and opens your browser once to set up a workspace. Restart Pi. From then on, every tool call is checked before it runs, and every decision lands in your activity log with the reason.

A new workspace starts in audit mode. Everything is recorded, and only the safety floor holds calls. Force-push, destructive SQL through a database client, curl | sh and deletes outside the project wait for your approval. rm -rf of your home directory or root is always blocked. The rules page has the full list.

The two events it uses

Pi sends every tool through two typed events. The extension listens to both.

  • tool_call fires before the tool runs. The extension asks the gateway (POST /govern/tool-use) and gets back allow, ask or deny. A deny blocks the call and puts the reason in the transcript.
  • tool_result fires after. The extension sends the output for scanning (POST /govern/tool-output) and can replace what the model reads, for example to redact a secret.

Pi has no MCP layer and no second path for tools. Built-ins and custom tools all go through those two events, so one file covers everything. No built-in quietly skips the hook.

What happens when a call is held

Pi tells the extension whether a person is at the keyboard (ctx.hasUI). It is true in the interactive terminal and false in print (pi -p) and JSON modes.

  • Interactive: an ask blocks the call in Pi. Approve it on the Approvals page or from the approval email, then tell Pi to retry.
  • Unattended: an ask becomes a deny, and the request shows up in the console for later review. There is no timeout and no silent yes, so an agent nobody is watching cannot approve its own call.

Only Claude Code shows a held call as a prompt inside the session. On Pi, the approval happens outside it.

If the gateway is unreachable

Interactive sessions keep going. The call runs, a [ACP] UNGOVERNED warning shows, and a line is written to ~/.acp/lapse.log. Unattended runs are blocked. A machine with no credentials is a no-op, and the extension says so at session start.

Model calls

The extension sees tool calls, not the model call behind them. The installer also adds a pi-acp launcher, next to claude-acp and codex-acp. It sends Pi’s model calls through ACP so they can be priced. Plain pi is untouched. That launcher shares a name with the npm package above and has nothing to do with it.

Where Pi lands on the coverage table

Pi gets a full row on the coverage matrix. The check sees everything Pi can do. A held call reaches you through the console and email. tool_result can rewrite output before the model reads it. The table changes whenever an integration ships, so read it there.

Frequently asked questions

Is pi acp the Agent Client Protocol?

The npm package pi-acp is. It is an Agent Client Protocol adapter (svkozak/pi-acp) that speaks ACP JSON-RPC over stdio to an editor such as Zed and runs Pi behind it. The ACP in this post is the Agentic Control Plane, a Pi extension that checks each tool call; ACP vs ACP explains the two.

pi agent acp: how do I install the control plane extension?

Run curl -sf https://agenticcontrolplane.com/install.sh | bash. The installer detects Pi, drops one TypeScript file at ~/.pi/agent/extensions/acp.ts, and signs you in once in the browser. Restart Pi. From the next session every Pi tool call is checked against your workspace policy before it runs. A new workspace starts in audit mode, where everything is recorded and only the safety floor holds calls.

pi coding agent acp: what does the extension record?

Every decision, with its reason, in your activity log: allow, ask or deny on tool_call, plus output scanning on tool_result.

Is this the same as pi-permission-system?

No. pi-permission-system is a community Pi extension that reads allow, ask and deny rules from a local pi-permissions.jsonc file. The Pi permissions reference covers it key by key.

Why an extension

Pi’s authors left permissions out and handed you the events to build them. The ACP extension fills that gap with workspace rules that decide, an audit record the agent did not write, and the same rules you use on your other harnesses.

It is one MIT-licensed file that imports only a Pi type. It has no runtime dependencies and no build step, and you can read it in a couple of minutes.

Running pi? One command adds a hook. Each tool call it sees is recorded, and a force-push, destructive SQL or curl | sh is blocked until you approve it on the console or from the email.

macOS · Linux · WSL
curl -fsSL https://agenticcontrolplane.com/install.sh | bash
Windows · PowerShell
irm https://agenticcontrolplane.com/install.ps1 | iex

What the installer writes  ·  pi guide  ·  free up to 5 agents

Share X HN LinkedIn
Get the next data drop
What agents actually cost, new tool-surface captures, and the occasional incident post-mortem — sent when we publish something worth your inbox, not on a schedule. Unsubscribe anytime.
Share: Twitter LinkedIn
Related posts

← back to blog