git-worktree-find

What problem does it solve?

Resolve and locate the filesystem path for a git branch's worktree and ensure a usable worktree exists for development; this removes manual searching, duplicate worktree creation, and confusion when switching contexts across ticket branches.

Core Features & Use Cases

• Detect existing worktrees by parsing git worktree list --porcelain and matching branch refs to return the absolute path when present.
• Create missing worktrees by invoking the prepare workflow (git-worktree-prepare) and applying local-file synchronization when needed, returning whether the worktree was created or reused.
• Verification and error guidance by confirming the branch in the resolved worktree and providing actionable errors when the branch name is invalid or git commands fail.
• Use Case: When a developer needs to work on a Linear ticket branch, run this Skill to either reuse an existing worktree or create a new one and receive the exact path and state.

Quick Start

Run git-worktree-find with the branch name to get the absolute worktree path and whether it was created or reused.