wu:recover

← Back to CLI Commands

wu:recover

Recover WU state, including restoring missing active worktrees

pnpm wu:recover --id <wuId>

Options:

Flag	Description	Required
-i, --id <wuId>	Work Unit ID (e.g., WU-123). If not provided, auto-generates next sequential ID.	Yes
-a, --action <action>	Recovery action: resume, restore, reset, nuke, cleanup, reconcile (non-destructively unstage a proven rolled-back completion tuple)	No
-f, --force	Required for destructive actions (reset, nuke)	No
--discard-changes	Allow reset to proceed even if worktree has uncommitted changes	No
-j, --json	Output as JSON	No
--override-owner	Override ownership check (requires —reason)	No
-r, --reason <reason>	Reason for action (required with —skip-gate, —override-owner)	No
--handoff-receipt <receipt>	Consume a durable wu:brief handoff receipt for cross-session recovery	No

---

← Back to CLI Commands