sbx/pi-acp repository overview

⁠Pi ACP adapter for Docker Sandboxes

This v3 mixin Kit adds an Agent Client Protocol adapter for Pi⁠ to a workload that already provides the agent. The adapter's runtime is included.

This Kit is built on Docker Hardened Images.

⁠Run

sbx run sbx/pi:latest --kit sbx/pi-acp:latest /path/to/workspace

⁠Kit arguments

This kit has no create-time kit arguments.

To configure the composed agent, set arguments on its workload or agent mixin, such as --kit-arg pi.model=anthropic/claude-sonnet-4-6. This mixin does not declare model or effort arguments.

⁠Authentication and configuration

The adapter uses the composed Pi agent and its authentication. It needs no separate provider credential or runtime package download. Configure an ACP client, such as Zed, to invoke the adapter over a non-TTY stream.

sbx exec -i <sandbox> pi-acp

ACP servers speak on standard input and output. They are not interactive terminal commands. You can also compose this adapter with Shell and the corresponding agent mixin.

⁠Related kits

• sbx/pi⁠ provides the complete agent workload.
• sbx/pi-mixin⁠ provides the agent overlay for a compatible workload.
• sbx/pi-sessions⁠ provides host-backed conversation state.

⁠Source and security

For the Kit format and capability contracts, see the Sandbox Kit v3 specification⁠.

For runtime setup, see the Docker Sandboxes documentation⁠. For provenance, SBOM, VEX, and image verification, see the Docker Hardened Images documentation⁠.

Pi is a product of Earendil Works, Inc. Product names and logos do not imply sponsorship or endorsement.