sbx/codex-acp
ACP adapter overlay for Codex. Requires the codex-mixin kit.
10K+
sbx/codex-acp repository overview
ACP adapter overlay for Codex. Requires the codex-mixin kit.
| Name | Required | Default | Description |
|---|---|---|---|
version | Required | — | codex-acp release the overlay carries |
[email protected]| Type | Required | Description | |
|---|---|---|---|
com.docker.sandbox/acp@1 | Optional | Drive codex sessions over the Agent Client Protocol | |
com.docker.sandbox/agent-context@1 | Optional | — | |
com.docker.sandbox/agent-context@2 | Optional | — | |
codexApply this mixin to a sandbox
sbx run <agent> --kit sbx/codex-acp:latestMake sure you have docker sbx installed
Run the following command to install sbx on your machine.
brew install docker/tap/sbxwinget install Docker.sbxCodex ACP adapter for Docker Sandboxes
This v3 mixin Kit adds an Agent Client Protocol adapter for Codex 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/codex:latest --kit sbx/codex-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 codex.model=gpt-5.
This mixin does not declare model or effort arguments.
Authentication and configuration
The adapter uses the composed Codex 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> codex-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/codex provides the complete agent workload.sbx/codex-mixin provides the agent overlay for a compatible workload.sbx/codex-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.
Codex and OpenAI are trademarks of OpenAI, L.L.C. Product names and logos do not imply sponsorship or endorsement.