docker

December 17, 2025 · View on GitHub

Utility commands for working with Docker images.

Subcommands

Command	Description
`make-dockerfile`	Generate a Dockerfile
`build-base`	Build base image for environment
`build-submission`	Build image for a submission
`build-agent`	Build image for an agent

make-dockerfile

Generate a Dockerfile for a docker environment.

Usage

slop-code docker make-dockerfile {base|agent} ENV_CONFIG_PATH

Arguments

Argument	Required	Description
`dockerfile`	Yes	Type: `base` or `agent`
`ENV_CONFIG_PATH`	Yes	Path to environment configuration file

Example

slop-code docker make-dockerfile base configs/environments/docker-python3.12-uv.yaml

build-base

Build the base image for a docker environment.

Usage

slop-code docker build-base [OPTIONS] ENV_CONFIG_PATH

Arguments

Argument	Required	Description
`ENV_CONFIG_PATH`	Yes	Path to environment configuration file

Options

Option	Type	Default	Description
`--force-build`	flag	false	Force rebuild even if image exists

Behavior

Reads environment specification
Generates Dockerfile for base image
Builds image with Docker client
Tags with environment name

Examples

# Build base image
slop-code docker build-base configs/environments/docker-python3.12-uv.yaml

# Force rebuild
slop-code docker build-base configs/environments/docker-python3.12-uv.yaml --force-build

build-submission

Build a docker image for a submission.

Usage

slop-code docker build-submission [OPTIONS] NAME SUBMISSION_PATH ENV_CONFIG_PATH PROBLEM_NAME

Arguments

Argument	Required	Description
`NAME`	Yes	Name for the built image
`SUBMISSION_PATH`	Yes	Path to submission directory
`ENV_CONFIG_PATH`	Yes	Path to environment configuration
`PROBLEM_NAME`	Yes	Name of the problem

Options

Option	Type	Default	Description
`--force-build`	flag	false	Force rebuild
`--build-base`	flag	false	Also rebuild base image

Behavior

Loads environment and problem configurations
Resolves static assets for the problem
Builds submission image with code and assets mounted
Tags with provided name

Examples

# Build submission image
slop-code docker build-submission my_submission \
  outputs/my_run/file_backup/checkpoint_1/snapshot \
  configs/environments/docker-python3.12-uv.yaml \
  file_backup

# With base rebuild
slop-code docker build-submission my_submission \
  outputs/snapshot \
  configs/environments/docker-python3.12-uv.yaml \
  file_backup \
  --build-base

build-agent

Build a docker image for an agent.

Usage

slop-code docker build-agent [OPTIONS] AGENT_CONFIG_PATH ENV_CONFIG_PATH

Arguments

Argument	Required	Description
`AGENT_CONFIG_PATH`	Yes	Path to agent configuration file
`ENV_CONFIG_PATH`	Yes	Path to environment configuration file

Options

Option	Type	Default	Description
`--force-build`	flag	false	Force rebuild agent image
`--force-build-base`	flag	false	Force rebuild base image too

Behavior

Loads agent and environment configurations
Uses agent's docker template if present
Builds image with agent-specific setup
Used automatically by run command when needed

Examples

# Build agent image
slop-code docker build-agent \
  configs/agents/claude_code-2.0.51.yaml \
  configs/environments/docker-python3.12-uv.yaml

# Force rebuild everything
slop-code docker build-agent \
  configs/agents/claude_code-2.0.51.yaml \
  configs/environments/docker-python3.12-uv.yaml \
  --force-build --force-build-base