Agentic AI Atlas

Wiki article

docs/agent-mux/tutorials/docker-mode

Reading · 2 min

Docker Invocation Mode reference

RunOptions.invocationMode = { kind: 'docker', ... } runs the agent inside a Docker container. The adapter builds the CLI args as usual; the invocation mode wraps them with docker run.

Page nodewiki/docs/agent-mux/tutorials/docker-mode.mdNearby pages · 9Documents · 0

Continue reading

Nearby pages in the same section.

Cost tracking Getting Started Hooks Kubernetes Invocation Mode Mock Harness Multi-Agent Dispatch Plugins (MCP)Remote bootstrap Sessions

Docker Invocation Mode

RunOptions.invocationMode = { kind: 'docker', ... } runs the agent inside a Docker container. The adapter builds the CLI args as usual; the invocation mode wraps them with docker run.

Quickstart

await client.run({
  agent: 'claude',
  prompt: 'Summarize this repo',
  invocationMode: {
    kind: 'docker',
    image: 'ghcr.io/a5c-ai/amux-runtime:latest',
    mounts: [{ host: process.cwd(), container: '/workspace' }],
    env: { ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY! },
    workdir: '/workspace',
  },
});

Or via CLI:

bash

amux run claude \
  --mode docker \
  --image ghcr.io/a5c-ai/amux-runtime:latest \
  --mount "$PWD:/workspace" \
  --prompt "Hello"

What the invocation mode adds

The resulting command looks like:

Code

docker run --rm -i \
  -v <host>:<container> \
  -e ANTHROPIC_API_KEY=... \
  -w /workspace \
  <image> \
  claude --output-format jsonl --prompt "Hello"

With `agent-mux-remote`

You can also nest amux itself:

await client.run({
  agent: 'agent-mux-remote',
  prompt: 'Hello',
  invocationMode: { kind: 'docker', image: 'my/amux:latest' },
  env: { AMUX_REMOTE_AGENT: 'claude' },
});

This runs amux run --json --agent claude --prompt ... inside the container, and streams events back.

Tips

Use a dedicated image that pre-installs the target agent CLI.
Pass secrets via -e or Docker secrets, not baked into the image.
Session files stay **inside the container** unless you mount the agent's session dir to the host.

See Invocation Modes for the full option surface.