Commands
contd validate [--config PATH] [--json]
contd run [options]
contd cancel [--reason TEXT] [--json] <run-id>
contd status [--json] <run-id>
contd runs [--json] [--limit N]
contd logs [--json] <run-id> [job]
contd artifacts [--json] [--all] <run-id>
contd artifacts download --output PATH <run-id> <artifact-id>
contd inspect [--json] <run-id>
contd analyze [options] <run-id>
contd daemon start [--socket PATH] [--json]
contd daemon status [--socket PATH] [--json]
contd daemon stop [--socket PATH]
contd submit [options]
contd help [command]
run options
| Option | Meaning |
|---|
--config PATH | Read a specific configuration file. |
--job NAME | Run one job and its prerequisites. |
--from NAME | Run a job, its dependents, and their prerequisites. |
--socket PATH | Use a specific daemon socket. |
--foreground, -fg | Run in the client instead of the daemon. |
--follow | Wait for a daemon run and print lifecycle events. |
--logs | Include live logs with --follow. |
--verbose | Print live logs in foreground mode. |
--json | Emit machine-readable output. |
submit options
| Option | Meaning |
|---|
--socket PATH | Daemon socket. |
--workspace PATH | Absolute workspace path. Defaults to the current directory. |
--config PATH | Config path. Defaults to the first discovered config name. |
--request-id ID | Stable ID for idempotent resubmission. |
--job NAME | Run one job and its prerequisites. |
--from NAME | Run a job, its dependents, and their prerequisites. |
--json | Print the queued request as JSON. |
analyze options
| Option | Default |
|---|
--job NAME | Required. |
--artifact ID | No artifacts unless selected. Repeatable. |
--data-policy POLICY | local-only. |
--max-context-bytes N | 131072. |
--max-log-bytes N | 32768 per log. |
--max-artifact-bytes N | 16384 per artifact. |
--max-artifacts N | 4. |
--max-turns N | 1. |
--max-tokens N | 1000. |
--max-budget N | Unlimited. |
--timeout DURATION | 30s. |
--json | Print the structured artifact. |
Application paths
| Path | Purpose |
|---|
.contd/contd.db | Run and lifecycle metadata for a submitted workspace. |
.contd/runs/<run-id>/ | Run-scoped logs, artifacts, and cancellation records. |
$XDG_RUNTIME_DIR/contd/contd.sock | Default daemon HTTP/JSON socket. |
~/.contd/contd.sock | Default socket when XDG_RUNTIME_DIR is unavailable. |
<socket>.grpc | Matching gRPC socket. |
The daemon queue database is stored beside its socket. These paths are application state, not inputs that a job should rely on.
JSON output
Commands with --json emit stable objects. run --follow --json emits one JSON object per lifecycle event and a final run object, making it suitable for line-oriented consumers.
Process exit codes
| Code | Meaning |
|---|
0 | Success. |
1 | CLI or infrastructure failure. |
2 | Configuration or validation failure. |
3 | Run failure or timeout. |
4 | Cancellation. |