jackin load

Synopsis

jackin load [SELECTOR] [TARGET] [OPTIONS]

Load an agent into an isolated Docker container. This is the primary command for starting an agent session.

SELECTOR chooses the agent class (tool profile). TARGET chooses the workspace or path (file access boundary).

Arguments

Argument	Required	Description
`SELECTOR`	No	Agent class selector (e.g., `agent-smith`, `chainargos/backend-engineer`). When omitted, uses the last-used or default agent for the workspace.
`TARGET`	No	Path, `path:container-dest`, or saved workspace name. Defaults to the current directory.

Options

Option	Description
`--mount <SPEC>`	Additional bind-mount spec. Repeatable. Format: `path[:ro]` or `src:dst[:ro]`
`--rebuild`	Force rebuild the Docker image (updates Claude to latest version)
`--no-intro`	Skip the animated intro sequence
`--debug`	Print raw container output for troubleshooting

Examples

# Use workspace + last agent for current directory
jackin load

# Force fresh Claude install
jackin load --rebuild

# Load a specific agent into current directory
jackin load agent-smith

# Load into a specific path
jackin load agent-smith ~/Projects/my-app

# Path with custom container destination
jackin load agent-smith ~/Projects/my-app:/app

# Load into a saved workspace
jackin load agent-smith big-monorepo

# Workspace with additional mounts
jackin load agent-smith big-monorepo --mount ~/extra-data

# Path with read-only additional mount
jackin load agent-smith ~/app --mount ~/cache:/cache:ro

What happens

Resolves the agent class and clones/updates its repository
Validates the agent repo contract (jackin.agent.toml + Dockerfile) with strict manifest parsing
Prompts for interactive environment variables declared in the manifest
Generates and builds a derived Docker image (cached if unchanged)
Creates a per-agent Docker network and DinD sidecar
Launches the agent container with all resolved mounts and environment variables
Runs the pre-launch hook if declared
Starts Claude Code with --dangerously-skip-permissions