outrig build

outrig build builds (or cache-hits) the image for one or more image-configs, without starting an agent session. It’s useful for:

• Verifying your Dockerfile builds cleanly before you start an agent.
• Pre-warming the image so the first outrig run is fast.
• CI: ensuring the agent’s environment still builds after a dependency bump.

Synopsis

outrig build [--image <name>]
             [--config <path>]
             [--no-cache]
             [--all]

• --image <name> (default: default-image): build a specific named image-config.
• --all (default: off): build every image-config defined in the config file.
• --config <path> (default: walks up from cwd): use a non-default config path.
• --no-cache (default: off): force rebuild even on cache hit. Passes --no-cache to buildah.

What it does

1. Loads .agents/outrig/config.toml and validates every image-config in the merged config. Agent/model wiring is not required for image builds.
2. For each selected image-config:
   • Computes the cache key (blake3 over Dockerfile content, resolved build-args, the OutRig labels derived from [images.<name>.mcp], and the context content hash).
   • If a tag matching that key exists and --no-cache is not set, prints image ready (cache hit) and skips.
   • Otherwise runs a buildah build to a temporary tag:

     buildah build --tag <image-config-name>:outrig-tmp-... \
                   --file <dockerfile> \
                   [user build-args] \
                   <context>
     

     Then it reads any inherited/Dockerfile org.outrig.mcp label, overlays [images.<name>.mcp], and commits the final <image-config-name>:<hash> image with the merged org.outrig.mcp label. The repository is the [images.<name>] block key, so the built image is self-describing in podman images; the <hash> is the content-addressed cache key.

Examples

Build the default:

$ outrig build
[outrig] image-config: coding
[outrig] dockerfile:       .agents/outrig/images/coding/Dockerfile
[outrig] context:          .agents/outrig/images/coding
[outrig] image tag:        coding:8c2a4f7e91d6b5a3
[buildah] STEP 1/6: FROM docker.io/library/node:20-bookworm-slim
...
[outrig] image ready: coding:8c2a4f7e91d6b5a3

Cache hit on the second run:

$ outrig build
[outrig] image ready (cache hit: coding:8c2a4f7e91d6b5a3)

Build a specific image-config:

$ outrig build --image planning
[outrig] image-config: planning
...
[outrig] image ready: planning:b91e3a6d217f4c08

Build every image-config in one go:

$ outrig build --all
[outrig] image-config: coding   -> coding:8c2a4f7e91d6b5a3 (cache hit)
[outrig] image-config: planning -> planning:b91e3a6d217f4c08 (built in 27s)
[outrig] all images ready

Force a rebuild without changing files:

$ outrig build --no-cache

Exit codes

• 0 – every selected image is built or cache-hit.
• non-zero – at least one image failed to build. The buildah stderr is reproduced with the [buildah] prefix, ending with the exact failing step.

See also

• Concepts -> Containers – Dockerfile conventions.
• Concepts -> Workspace – runtime UID/GID mapping (no build-time user setup needed).
• outrig run – what gets run after the image is ready.
• Reference -> CLI – every flag.