Devin CLI overlay for a shell workload, with its auth wrapper, credentials, and MCP setup.
9.2K
Devin CLI overlay for a shell workload, with its auth wrapper, credentials, and MCP setup.
| Name | Required | Default | Description |
|---|---|---|---|
version | Required | — | Devin CLI release to install |
[email protected]| Type | Required | Description | |
|---|---|---|---|
com.docker.sandbox/network-policy@1 | Required | — | |
com.docker.sandbox/credential@1 | Optional | Devin account credential captured during in-sandbox login | |
com.docker.sandbox/lifecycle@1 | Required | — | |
com.docker.sandbox/agent-context@1 | Optional | — | |
com.docker.sandbox/agent-context@2 | Optional | — | |
com.docker.sandbox/acp@1 | Optional | — | |
sbx run <agent> --kit sbx/devin-mixin:latestRun the following command to install sbx on your machine.
brew install docker/tap/sbxwinget install Docker.sbxThis v3 mixin Kit packages Devin 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.
sbx run sbx/shell:latest --kit sbx/devin-mixin:latest /path/to/workspace
When the shell opens, run devin. This kit supplies an overlay, so it needs a workload such as
Shell.
A manual devin launch keeps its native approval behavior. To match the workload's automatic tool approval, run:
devin --permission-mode dangerous --respect-workspace-trust=false
Use the devin wrapper so authentication setup still runs.
This kit has no create-time kit arguments.
Run devin and complete its sign-in flow inside the sandbox. The devin wrapper replaces the durable credential on
disk with a proxy placeholder before launching devin-cli. Use the wrapper for interactive sessions.
Devin embeds an intermediate OAuth token in a protobuf request body that the proxy cannot rewrite. The kit permits that real, short-lived intermediate token to enter the sandbox, which a runtime policy may refuse. The durable account credential remains proxy-held.
When the runtime supplies an MCP gateway, the kit registers it automatically in ~/.config/devin/mcp_config.json.
Startup replaces this entire file whenever a gateway is configured. Back up custom entries before restarting the
sandbox.
ACP support is included. Configure an ACP client to open a non-TTY stream to the sandbox.
sbx exec -i <sandbox> devin-cli acp
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.
sbx/devin provides the complete agent workload.sbx/devin-sessions provides host-backed conversation state.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.
Devin is a product of Cognition. Product names and logos do not imply sponsorship or endorsement.