CLI reference
kusaw verify-world
Build an isolated world and check that a factory run does not leak
kusaw verify-world
Build an isolated world and check that a factory run does not leak
Usage
kusaw verify-world [flags]Flags
| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--agents | string | fake | fake (default) or real agent CLIs | |
--budget-usd | float64 | 1 | Dollar budget for --agents real | |
--config | string | Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search) | ||
--factory | string | factory name from kusaw list | ||
--help | -h | bool | false | help for verify-world |
--json | bool | false | Print the ledger report as JSON | |
--keep | bool | false | Keep the world folder after PASS | |
--model-claude | string | Claude model override for --agents real | ||
--model-cursor | string | Cursor model override for --agents real | ||
--scenario | stringArray | Scenario to run (repeatable; all runs each) | ||
--steps-from | string | Factory folder whose custom command: steps are copied into the world |
Subcommands
kusaw verify-world doctor
Print machine facts for verify-world (names only, never secret values)
kusaw verify-world doctor [flags]| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--config | string | Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search) | ||
--factory | string | factory name from kusaw list | ||
--help | -h | bool | false | help for doctor |
Example:
kusaw verify-world doctorExit codes
| Code | Name | Description |
|---|---|---|
| 0 | ok | Success. |
| 1 | error | Runtime error. |
| 2 | usage | Usage or validation error. |
| 3 | rejected | Control request rejected; the error string is printed verbatim. |
| 4 | not picked up | Control request not picked up within the wait time while serve runs. |
Example
kusaw verify-world --scenario basic --agents fake