---
source: tests/test_help.rs
expression: normalized
---
$ govctl loop --help
Loop execution-state commands
Usage: govctl loop [OPTIONS] <COMMAND>
Commands:
list List persisted local loop states
start Start a loop for one or more explicit work items
show Show persisted loop state
resume Resume or inspect an existing non-terminal loop
replan Recompute dependency closure for the current explicit work set
add Add a value to a loop field and replan when needed
remove Remove a value from a loop field and replan when needed
run Advance the local round protocol for ready work items
help Print this message or the help of the given subcommand(s)
Options:
-C, --config <CONFIG> Path to govctl config (TOML)
--dry-run Dry run: preview changes without writing files
-h, --help Print help
COMMON WORKFLOW:
1. `govctl loop list open` to discover existing non-terminal loops
2. `govctl loop start WI-<DATE>-001` to create local loop state
3. `govctl loop run <LOOP-ID>` to open or close a local round
4. `govctl loop show <LOOP-ID>` to inspect persisted state
5. `govctl loop resume <LOOP-ID>` to resume discovered loop state
6. `govctl loop add <LOOP-ID> work WI-<DATE>-002` to expand scope
NOTES:
- Loop state is local under `.govctl/loops/<LOOP-ID>/state.toml`.
- Use `loop list open` before guessing a loop ID or work set after interruption.
- Use `loop run <LOOP-ID> --work <WI-ID>` to target work when opening a round.
- `loop run` records and validates round evidence; Work Item lifecycle changes use `work move`.
exit: 0