cyberneticlibrary

Manage Git worktrees

wtcommandsetup L217
HomericIntelligence/ProjectOdyssey
What it does

Manage git worktrees for GitHub issues

Best for

Isolating work on individual GitHub issues using git worktrees, avoiding context switching between branches in a single checkout.

Inputs
  • · subcommand: list | create | cleanup | switch
  • · issue number (for create/switch)
Outputs
  • · worktree list with paths
  • · new worktree branch created
  • · merged branches removed
  • · cd command to switch
Requires
  • · git
  • · gh CLI
Preconditions
  • · git repository initialized
  • · gh CLI authenticated
  • · worktree/ directory exists or will be created
Failure modes
  • · issue not found (gh view fails)
  • · branch already exists (worktree add fails)
  • · worktree not merged (cleanup skips it)
Trust signals
  • · branch naming from issue title
  • · cleanup detects merged branches only
  • · prune cleans stale references