worktree

Manage component-backed task worktrees for generic Homeboy workflows.

Commands

  • homeboy worktree create <component-id> --branch <branch> [--from <ref>] [--task-url <url>] [--run-id <id>]
  • homeboy worktree list
  • homeboy worktree status <id>
  • homeboy worktree remove <id> [--force]
  • homeboy worktree cleanup [--force]

Safety

Removal refuses dirty worktrees, unpushed commits, primary checkouts, and paths outside the component checkout parent. --force only bypasses dirty/unpushed checks; primary checkout and containment gates always apply.