wu:claim

← Back to CLI Commands

wu:claim

Claim WU and create worktree

pnpm wu:claim --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
-l, --lane <lane>	Lane name (e.g., “Operations: Tooling”)	No
-w, --worktree <path>	Set the local worktree path; claims verify its confined realpath and exact Git registration	No
-b, --branch <branch>	Set the effective claim branch; local worktree claims persist its verified binding	No
--branch-only	Use branch-only mode without a claimed lane worktree; completion publishes from an isolated temporary worktree	No
--pr-mode	Use PR mode (create PR instead of auto-merge)	No
--no-auto	Skip auto-updating YAML/backlog/status	No
-f, --force	Force operation	No
--force-overlap	Force claiming despite overlap (requires —reason)	No
--fix	Auto-fix common YAML validation issues	No
-r, --reason <reason>	Reason for action (required with —skip-gate, —override-owner)	No
--allow-incomplete	Allow claiming with incomplete spec (bypasses spec completeness, NOT schema errors)	No
--cloud	Use cloud/branch-pr mode (no worktree, PR-based completion for cloud agents and MCP callers)	No
--resume	Resume a WU from a crashed/killed agent (handoff) by taking over the existing worktree and updating the lock with new PID. Fails if original PID is still running (safety) or worktree does not exist.	No
--skip-setup	Skip automatic pnpm install in worktree after creation (faster claims when deps already built)	No
--no-push	Skip pushing claim branch or canonical updates (air-gapped/offline)	No
--wait-for-lane	Queue the claim when code-path overlaps exist and auto-fire once every blocker WU has merged	No
--wait-timeout-seconds <seconds>	Maximum seconds to wait for blocker WUs to merge before giving up (default 3600, used with —wait-for-lane)	No
--cancel-queue	Cancel an active queued claim for —id (pairs with —wait-for-lane)	No

---

← Back to CLI Commands