git-worktree

Create, list, switch, and clean up Git worktrees with validation.

10|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/aimi-so/aimi-engineering-plugin --skill git-worktree-aimi-so
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktree
Source: https://github.com/aimi-so/aimi-engineering-plugin/tree/main/plugins/aimi-engineering/skills/git-worktree
Command: npx skills add https://github.com/aimi-so/aimi-engineering-plugin --skill git-worktree-aimi-so

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Managing multiple Git worktrees can become error-prone and hard to track. This skill provides a simple, opinionated manager to create, list, switch, and clean up worktrees with guardrails.

Core Features & Use Cases

  • Create worktrees from a base branch and automatically manage environment setup.
  • List all worktrees with their associated branches and status.
  • Switch between worktrees for isolated, parallel development.
  • Cleanup inactive worktrees to keep the repository clean and fast.
  • Integrates with workflows to support safe multi-feature development.

Quick Start

Create a new worktree with a unique branch name and switch into it to start parallel development.

Frequently Asked Questions about git-worktree

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

FAQPage Schema
How do I manage Git worktrees for parallel development across multiple features?

Git worktrees allow you to manage parallel development by creating isolated working directories from a base branch through a script-based interface. This manager handles environment setup and applies strict validation to track and clean up concurrent feature branches safely.

What is the best way to set up environment variables when creating a new Git worktree?

The best way to set up environment variables when creating a Git worktree is using a dedicated copy-env function. This manager automatically handles environment setup during worktree creation, ensuring isolated feature branches have the correct configuration from the base branch.

How do I clean up inactive Git worktrees to keep my repository fast?

You clean up inactive Git worktrees using a dedicated cleanup command that safely removes inactive directories. This keeps your repository clean and fast by removing isolated working directories that are no longer needed for concurrent feature work.

Can I switch between Git worktrees without manually changing directories?

Yes, you can switch between Git worktrees directly using a dedicated switch command. This allows you to transition instantly between isolated parallel development branches without manually navigating the file system or risking context loss.

Does this Git worktree manager require any external dependencies or tools?

No, this Git worktree manager does not require external dependencies. It relies on a script-based interface to handle worktree creation, environment handling, and strict validation, making it a self-contained solution for isolated parallel development.

When should I use Git worktrees instead of standard Git branches?

You should use Git worktrees instead of standard Git branches when you need isolated parallel development across multiple features simultaneously. Worktrees let you check out multiple branches at once, preventing context switching errors and keeping your repository clean.