Table of Contents

Examples

Build a base image

docker build -t agentcontainers/node-bun:latest generated/docker/bases/node-bun
docker run --rm agentcontainers/node-bun:latest node --version

Build an agent overlay from a local base

docker build -t agentcontainers/node-bun-claude:latest generated/docker/agents/node-bun-claude
docker run --rm agentcontainers/node-bun-claude:latest claude --version

Build an agent overlay from a published base image

docker build \
  --build-arg BASE_IMAGE=ghcr.io/agentcontainers/node-bun:latest \
  -t ghcr.io/agentcontainers/node-bun-codex:latest \
  generated/docker/agents/node-bun-codex

Run a compose stack

export ANTHROPIC_API_KEY=...
docker compose -f generated/compose/stacks/solo-claude/docker-compose.yaml up

Run a richer stack with Headroom

export ANTHROPIC_API_KEY=...
docker compose -f generated/compose/stacks/gateway-headroom/docker-compose.yaml up

Generate and inspect the matrix

dotnet run --project src/AgentContainers.Generator --configuration Release -- list-matrix
dotnet run --project src/AgentContainers.Generator --configuration Release -- list-matrix --json

Build the docs site

dotnet tool restore
dotnet tool run docfx docs/docfx.json --warningsAsErrors