@gw-git-worktree-workflows

Manage multiple Git worktrees with the gw CLI for isolated branches.

8|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/mthines/gw-tools --skill gw-git-worktree-workflows
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: @gw-git-worktree-workflows
Source: https://github.com/mthines/gw-tools/tree/main/skills/%40gw-git-worktree-workflows
Command: npx skills add https://github.com/mthines/gw-tools --skill gw-git-worktree-workflows

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables managing multiple Git worktrees in parallel using the gw CLI to isolate branches and preserve working directories.

Core Features & Use Cases

  • Creating and managing worktrees with automatic navigation and optional auto-copy of configured files.
  • Smart navigation between worktrees using gw cd and smart branch-aware checkout.
  • Conflict resolution, cleanup, and maintenance workflows across multiple worktrees.
  • Use cases include feature development, hotfixing, code reviews, and testing across multiple environments.

Quick Start

To get started, install gw, initialize your repository configuration, then create and switch between worktrees. For example, gw init, gw add feature-auth -b feature-auth main, gw cd feature-auth, gw sync feature-auth, and gw remove feature-auth when finished.

Frequently Asked Questions about @gw-git-worktree-workflows

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

FAQPage Schema
How do I manage Git worktrees for parallel development without losing my working directory?

Git worktrees isolate branches in parallel directories to preserve active work. You create a worktree, switch branches, and handle feature development or hotfixes without interrupting your current working directory state.

How do I create a Git worktree and automatically navigate to it?

Use the gw CLI to create a worktree with automatic navigation and optional auto-copy of configured files. Running a command like gw add feature-auth -b feature-auth main sets up the worktree and switches you into it immediately.

What is the best way to handle hierarchical branch conflicts in Git worktrees?

Hierarchical branch conflicts in Git worktrees are handled through smart branch-aware checkout and dedicated conflict resolution workflows. These workflows detect and manage branch dependencies to prevent isolation errors during parallel development.

How do I safely clean up and remove Git worktrees after finishing a feature?

Safe cleanup of Git worktrees involves dedicated maintenance workflows that remove the worktree directory and its associated branch tracking. Using a command like gw remove feature-auth ensures safe deletion without affecting other active worktrees.

Can I use Git worktrees for cross-environment testing and code reviews?

Git worktrees support cross-environment testing and code reviews by maintaining isolated branch copies. You can test different environments or review code in separate directories without stashing or committing your active development work.

Do I need the gw CLI to manage multiple Git worktrees for feature development?

The gw CLI is required to manage multiple Git worktrees using these workflows. It provides the initialization, smart navigation, file synchronization, and safe removal functions needed for effective parallel branch isolation.