CLI reference
kusaw order
List, show, check, and control Work orders
kusaw order
List, show, check, and control Work orders
Usage
kusaw order [flags]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 order |
Subcommands
kusaw order approve
Approve a Work order plan and snapshot it
kusaw order approve <id> [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 approve |
--note | string | Note stored with the approval | ||
--yes | bool | false | Approve without a prompt |
Example:
kusaw order approve wo-20261104-csv-export --yeskusaw order cancel
Cancel a Work order; stop its running runs and keep every branch
kusaw order cancel <id> [flags]| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--clean | bool | false | Also remove kept milestone and feature-run branches after cancel | |
--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 cancel |
Example:
kusaw order cancel wo-20261104-csv-export
kusaw order cancel --clean wo-20261104-csv-exportkusaw order check
Check Work order plan rules
kusaw order check <id> [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 check |
Example:
kusaw order check wo-20261104-csv-exportkusaw order checks
Show milestone check answers for a Work order
kusaw order checks <id> [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 checks |
--json | bool | false | Print JSON | |
--milestone | string | Milestone id (default: latest with checks) | ||
--round | int | 0 | Check round (default: latest) |
Example:
kusaw order checks wo-20261104-csv-export --milestone M1kusaw order clean
Remove kept branches of a finished Work order
kusaw order clean <id> [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 clean |
Example:
kusaw order clean wo-20261104-csv-exportkusaw order list
List Work orders
kusaw order list [flags]| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--all | bool | false | Include finished Work orders | |
--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 list |
--json | bool | false | Print JSON |
Example:
kusaw order listkusaw order new
Plan a Work order from a goal sentence
kusaw order new <goal> [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 | ||
--from | string | Copy an existing plan folder and run plan-check only | ||
--help | -h | bool | false | help for new |
--repo | stringArray | Repo label; repeat for each repo the change touches | ||
--title | string | Work order title (default: the goal) |
Example:
kusaw order new "Add CSV export to the invoices table" --repo demokusaw order note
Append a note to a Work order
kusaw order note <id> <text> [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 note |
Example:
kusaw order note wo-20261104-csv-export "The invoices table has a soft-delete column"kusaw order pause
Pause a Work order; running runs finish and no new run starts
kusaw order pause <id> [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 pause |
Example:
kusaw order pause wo-20261104-csv-exportkusaw order ready
Run Work order readiness probes at the base
kusaw order ready <id> [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 ready |
--json | bool | false | Print JSON |
Example:
kusaw order ready wo-20261104-csv-export --jsonkusaw order resume
Resume a paused or needs_attention Work order, or accept unchecked assertions
kusaw order resume <id> [flags]| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--accept | stringSlice | Assertion ids to record as passed by you | ||
--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 resume |
--note | string | Note stored with the resume or accept |
Example:
kusaw order resume wo-20261104-csv-export --note "continue"
kusaw order resume wo-20261104-csv-export --accept A2 --note "covered by hand"kusaw order show
Show one Work order
kusaw order show <id> [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 show |
--json | bool | false | Print JSON | |
--notes | bool | false | Print the Work order notes file |
Example:
kusaw order show wo-20261104-csv-export --jsonExit 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 order list