svkozak/pi-acp

What it solves

It provides a bridge between the pi coding agent and any client that supports the Agent Client Protocol (ACP), such as the Zed editor. This allows users to use the pi agent's capabilities directly within their IDE rather than relying solely on a terminal interface.

How it works

pi-acp acts as an adapter that communicates using ACP JSON-RPC 2.0 over standard input/output (stdio). It spawns the pi agent in RPC mode (pi --mode rpc) and translates requests and events between the ACP client and the agent.

Who it’s for

Developers who use the pi coding agent and want to integrate it into an ACP-compatible editor like Zed for a more seamless coding experience.

Highlights

• IDE Integration: Enables pi to work within ACP clients, supporting features like streaming assistant output and tool call mapping.
• Context Awareness: Resolves relative file paths and attempts to infer line numbers for edits to help the editor follow along with agent changes.
• Session Management: Supports session persistence and history, allowing users to reattach to previous sessions in both the editor and the terminal.
• Command Support: Integrates file-based slash commands, built-in utility commands (like /compact and /export), and skill commands.
• Structured Diffs: Captures file snapshots before tool execution to emit structured diffs (oldText/newText) upon completion.