reference

CLI

Every command, every flag in v0.3.0-beta.2. Run any command with --help for the same content inline.

lifecycle

dclaw init

Bootstrap config, fleet, and state dirs. Idempotent. Pulls the default agent image on first run.

dclaw doctor

Diagnose: docker reachable? ports clear? write perms? Returns non-zero on failure with actionable hints.

dclaw upgrade

Pull the latest agent image and restart the daemon if needed. Respects pinned versions in fleet.yaml.

daemon

dclaw daemon start

Start the control plane in the background. PID at ~/.local/state/dclaw/daemon.pid.

dclaw daemon stop

Graceful shutdown. Sends SIGTERM, waits for in-flight tool calls to drain, then exits.

dclaw daemon status

Daemon health + uptime + active agent count. Exit 0 if running.

dclaw daemon logs [--tail=N] [-f]

Stream the daemon log. JSON-lines; pipe to jq.

agent

dclaw agent create <name>

Spawn a new agent container.

--image OCI image. Default: dclaw-agent:v0.1

--workspace Host path to bind-mount. Validated against denylist.

--workspace-trust Override the denylist. Logged. Use only if you know what you're doing.

--model anthropic/claude-3-5-sonnet | openai/gpt-4o | google/gemini-1.5-pro | … (via pi-mono)

--max-cost Hard cap on API spend. Daemon kills the container at the threshold.

dclaw agent chat <name>

Open an interactive chat session. Streams tool output.

--one-shot 'msg' Send a single message and exit.

--no-tools Disable tool use for this session.

dclaw agent list

All agents the daemon knows about, with status + uptime.

dclaw agent logs <name>

Per-agent log. Includes model calls, tool execs, sandbox events.

dclaw agent destroy <name>

Stop + remove the container. Workspace is preserved unless --purge.

fleet

dclaw up

Reconcile running agents against fleet.yaml. Creates missing, restarts drifted, leaves matching alone.

dclaw status

Per-agent: spec source, image, container state, last health check.

dclaw logs [--agent=<name>] [-f]

Aggregate logs across the fleet.

Exit codes

success

user error (bad flag, unknown agent, etc)

daemon unreachable

docker unreachable

workspace denied (path on denylist, no --workspace-trust)

image pull failed

model provider auth failed