$ cat ~/map/pi-acp.md

pi-acp

Community ACP (Agent Client Protocol) adapter that bridges JSON-RPC 2.0 between ACP clients such as the Zed editor and Pi running in RPC mode over stdio.

extensions✓ Oct 16

Facts

repository: github.com/svkozak/pi-acp ↗
GitHub Stars: ★ 735
Forks: 200
license: MIT
npm / mo: —
last push: Oct 6, 2026

## TL;DR

Agent Client Protocol adapter for pi: speaks ACP JSON-RPC 2.0 over stdio to editors like Zed and bridges to pi --mode rpc, bringing pi sessions, tool calls with structured diffs, slash commands, and skills into the editor.

## Key points

$Bridging model: the adapter spawns pi --mode rpc and translates between ACP messages and pi events — assistant output streams as agent_message_chunk, tool execution maps to tool_call/tool_call_update.
$Editor-friendly edits: for the edit tool it snapshots the file, infers a 1-based line number from a unique oldText match, and emits an ACP structured diff (oldText/newText) on completion; relative paths resolve against the session cwd so clients like Zed can follow along.
$Session persistence: pi keeps its own session files while a small map at ~/.pi/pi-acp/session-map.json lets session/load reattach — sessions resume in both pi and the ACP client (Zed history supported since v0.225.0).
$Loads pi-convention file-based slash commands plus a small built-in set for headless/editor use; pi skills appear as /skill:skill-name when enabled.
$Requires pi v0.80.4+ on PATH and Node 22+; explicitly an MVP — some ACP features unimplemented, minor breaking changes expected.

## FAQ

Q How do I use it with Zed?

Easiest is the ACP registry: run zed: acp registry and pick the pi ACP adapter, which manages the config. Manually, add an agent_servers entry running npx -y pi-acp (or pi-acp after npm install -g pi-acp).

Q How do I silence the startup info block?

Set quietStartup: true in pi settings (~/.pi/agent/settings.json or <project>/.pi/settings.json); a 'new version available' notice still appears when the installed pi is outdated.

pi-acp

## TL;DR

## Key points

## FAQ

## References

## Related entries

## Guides