git-worktree-guide

Guide git worktree creation, switching, listing, deletion with the wt script.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/trounceabout/wt --skill git-worktree-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktree-guide
Source: https://github.com/trounceabout/wt/tree/main/docs
Command: npx skills add https://github.com/trounceabout/wt --skill git-worktree-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing multiple git worktrees across a single repository can be error-prone and hard to coordinate. This guide explains how to use the wt script to simplify creating, switching, listing, and deleting worktrees while avoiding conflicts and keeping workspaces organized.

Core Features & Use Cases

  • Guidance on when and why to use git worktrees for parallel development, PR reviews, and long-running tasks
  • Safe naming conventions, configuration tips, and troubleshooting workflows that minimize disruption to your primary worktree
  • Clear workflows showing how to create a new worktree, switch between worktrees, and clean up when done

Quick Start

Try wt list to view current worktrees, then create a new worktree with wt create DEV-123 and switch into it with wt switch DEV-123

Frequently Asked Questions about git-worktree-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use git worktrees for parallel feature development?

Git worktrees let you maintain multiple working directories from a single repository, enabling parallel feature development without stashing or switching branches. The wt script guides creation, switching, and deletion to keep workspaces organized.

What is the best way to manage multiple git worktrees without conflicts?

Using the wt script is the best way to manage multiple git worktrees without conflicts. It enforces safe naming conventions, configuration tips, and structured workflows for creating, switching, and deleting worktrees reliably.

How do I create and switch to a new git worktree for a PR review?

To create and switch into a new git worktree for PR review, use the command wt create DEV-123 followed by wt switch DEV-123. This isolates your review workspace without disrupting your primary development branch.

When should I use git worktrees instead of cloning a repository again?

Use git worktrees for long-running builds, PR reviews, and parallel feature development within a single repository. They share git history, avoiding the storage overhead and synchronization issues of maintaining multiple clones.

How do I safely delete a git worktree without breaking my main repository?

To safely delete a git worktree, follow the wt script's safe deletion practices and troubleshooting workflows. This prevents broken references and ensures your primary worktree and main repository remain completely intact.