Sign inSign up
docker-agent-mixin logo

sbx/docker-agent-mixin

Verified Publisher

By Docker, Inc

•Updated about 12 hours ago

Docker Agent overlay for a shell workload, with provider credentials and scoped egress.

Sandbox Kit
0

7.7K

sbx/docker-agent-mixin repository overview

Digest

sha256:a3f46718a3bb…

Size

29.6 MB

Schema

v3

Pushed

about 12 hours ago

Specificationspec.yaml

MIXIN

Docker Agent overlay for a shell workload, with provider credentials and scoped egress.


Arguments
NameRequiredDefaultDescription
versionRequired—

Docker Agent release the image 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@1OptionalAnthropic API access
com.docker.sandbox/credential@1OptionalGitHub and Copilot access
com.docker.sandbox/credential@1OptionalGoogle AI API access
com.docker.sandbox/credential@1OptionalMistral API access
com.docker.sandbox/credential@1OptionalNebius API access
com.docker.sandbox/credential@1OptionalOpenAI API access
com.docker.sandbox/credential@1OptionalOpenRouter API access
com.docker.sandbox/credential@1OptionalxAI API access
com.docker.sandbox/agent-context@1Optional—
com.docker.sandbox/agent-context@2Optional—
com.docker.sandbox/acp@1Optional—

Apply this mixin to a sandbox

sbx run <agent> --kit sbx/docker-agent-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⁠

⁠Docker Agent mixin for Docker Sandboxes

This v3 mixin Kit packages Docker Agent⁠ 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/docker-agent-mixin:latest /path/to/workspace

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

The --yolo option allows tool execution without approval prompts. Omit it to use Docker Agent's native approval behavior.

For a single prompt, run this command inside the shell. Do not combine --exec with --agent-picker.

docker-agent run --yolo --exec default "Summarize this repository"

⁠Kit arguments

This kit has no create-time kit arguments.

⁠Authentication and configuration

Bind the provider credentials your agent configuration uses on the host. Supported services are anthropic, github, google, mistral, nebius, openai, openrouter, and xai. For example, run sbx secret set anthropic. Credentials remain proxy-managed.

Automatic agent updates are disabled. Select a newer kit tag when you want a different Docker Agent release.

Use literal provider API keys. A Claude subscription login does not supply an Anthropic API key, and a ChatGPT subscription does not supply an OpenAI API key. Bind the matching API key on the host.

ACP support is included. Configure an ACP client to open a non-TTY stream to the sandbox.

sbx exec -i <sandbox> docker-agent serve acp default

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.

If a tool cannot reach a service, run sbx policy log on the host to identify blocked destinations.

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

Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. Product names and logos do not imply sponsorship or endorsement.