CLI Reference

The goatcs-harness command-line interface is the primary entry point for running, verifying, and managing skill executions.

Commands

Execute a skill graph.

bash

1	`goatcs-harness run <graph.json> --seed <seed.json> --provider <provider> [--read-dir <dir>] [--scratch-dir <dir>] [--resume <session>]`

Flag	Description
`--seed <path>`	JSON file with initial state (required)
`--provider inline / claude-cli / codex`	Execution provider
`--read-dir <dir>`	Allow file reads from this directory
`--scratch-dir <dir>`	Session scratch directory
`--resume <session>`	Resume a checkpointed session

Validate a graph topology.

bash

1	`goatcs-harness verify <graph.json> [--strict-wiring]`

Checks: node types, edge types, gate conditions, wave assignments, schema compliance.

Verify skill wiring against a contract.

bash

1	`goatcs-harness wiring-check <skill-dir>/ --contract wiring-contract.yaml`

Submit output for a paused inline node.

bash

1	`goatcs-harness submit <node-id> --session <dir> --inline --outputs <file.json>`

Fork a session at a specific sequence number.

bash

1	`goatcs-harness fork <session-dir> --at-seq <n>`

Hand off a session between agents.

bash

1	`goatcs-harness handoff <session-dir> --from claude --to codex`

Code	Meaning
0	Success
1	Error (graph validation, runtime failure)
11	HITL pause (inline provider waiting for input)
20	Sufficiency refusal (input too sparse)
21	Gate failure
22	File-system error