Sign inSign up
codex-mixin logo

sbx/codex-mixin

Verified Publisher

By Docker, Inc

•Updated about 14 hours ago

Codex CLI overlay for a shell workload, with OpenAI credentials and agent hooks.

Sandbox Kit
0

10K+

sbx/codex-mixin repository overview

Digest

sha256:41445fffcd6d…

Size

156.3 MB

Schema

v3

Pushed

about 14 hours ago

Specificationspec.yaml

MIXIN

Codex CLI overlay for a shell workload, with OpenAI credentials and agent hooks.


Arguments
NameRequiredDefaultDescription
modelOptional

Codex model to use (config.toml `model`); empty keeps the CLI default

reasoningEffortOptional

Reasoning effort (config.toml `model_reasoning_effort`); empty keeps the CLI default

versionRequired—

Codex CLI release the overlay carries



CapabilitiesExpand a row to see its full configuration. See the full spec for the complete descriptor.
TypeRequiredDescription
com.docker.sandbox/network-policy@1Required—
com.docker.sandbox/credential@1OptionalOpenAI API access (API key or ChatGPT OAuth)
com.docker.sandbox/lifecycle@1Required—
com.docker.sandbox/agent-skills@1Optional—
com.docker.sandbox/agent-context@1Optional—
com.docker.sandbox/agent-context@2Optional—

Apply this mixin to a sandbox

sbx run <agent> --kit sbx/codex-mixin:latest

Make sure you have docker sbx installed

Run the following command to install sbx on your machine.

macOS
brew install docker/tap/sbx
Windows
winget install Docker.sbx
Learn more about docker sbx⁠

⁠Codex mixin for Docker Sandboxes

This v3 mixin Kit packages Codex⁠ for Docker Sandboxes. It adds the agent, authentication configuration, and runtime integration to a compatible workload. The workload keeps its entrypoint.

This Kit is built on Docker Hardened Images.

⁠Run

sbx run sbx/shell:latest --kit sbx/codex-mixin:latest /path/to/workspace

When the shell opens, run codex. This kit supplies an overlay, so it needs a workload such as Shell⁠.

⁠Kit arguments

Set these arguments when creating the sandbox with --kit-arg <name>=<value>. Repeat the flag for multiple arguments. Use --kit-arg <kit>.<name>=<value> to target one kit in a composition, as in the example below.

ArgumentDefaultDescriptionAccepted values
model""Codex model to use (config.toml model); empty keeps the CLI defaultLetters, digits, ., _, and -.
reasoningEffort""Reasoning effort (config.toml model_reasoning_effort); empty keeps the CLI defaultEmpty, none, minimal, low, medium, high, xhigh, max, ultra, or persistent.

An empty value keeps the agent default. The model must be available to your provider account, and the selected model must support the requested effort or thinking level. These are kit configuration inputs, separate from agent command-line arguments passed after --.

sbx run sbx/shell:latest --kit sbx/codex-mixin:latest \
  --kit-arg codex-mixin.model=gpt-5 --kit-arg codex-mixin.reasoningEffort=high \
  /path/to/workspace

⁠Authentication and configuration

Bind an OpenAI API key on the host with sbx secret set openai. For a ChatGPT login, run sbx secret set openai --oauth on the host. You can also sign in from Codex inside the sandbox. Host-bound credentials remain proxy-managed.

The sandbox supplies the isolation for agent tool execution. Launch the kit through Docker Sandboxes and configure extra tool or MCP destinations in the runtime network policy as needed.

⁠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.