using-git-worktrees

Create isolated git worktrees for feature branches with safety checks.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/ironbob/SuperPower_light --skill using-git-worktrees-ironbob
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/ironbob/SuperPower_light/tree/main/skills/using-git-worktrees
Command: npx skills add https://github.com/ironbob/SuperPower_light --skill using-git-worktrees-ironbob

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Starting feature work without disrupting the current workspace by creating isolated git worktrees.

Core Features & Use Cases

  • Create isolated workspaces that share the repository history but allow independent branches.
  • Smart directory selection (prefers .worktrees, then worktrees, then global location) and safety verification to prevent accidental commits of worktrees.
  • Automatic project-name detection and environment setup steps to quick-start feature work.

Quick Start

Ask me to initialize an isolated git worktree for your next feature branch.

Frequently Asked Questions about using-git-worktrees

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

FAQPage Schema
How do I create an isolated git worktree for feature development?

To create an isolated git worktree, the tool automatically selects a deterministic directory, verifies project-local checks, and sets up an independent branch without altering your main workspace. It shares repository history while keeping feature work safely separated.

What is a git worktree and when do I need one for branching?

A git worktree is an isolated workspace that shares repository history but allows independent branch development. You need one when starting feature work in a shared repo to safely isolate changes without disrupting your current main workspace.

Can I prevent accidental commits when using git worktrees?

Yes, the tool enforces safety verification and guardrails to prevent accidental commits of worktrees. It performs project-local directory checks and applies CLAUDE.md preferences to ensure isolated feature development remains safe and deterministic.

What's the best way to manage multiple git branches without altering the main workspace?

Using git worktrees is the best way to manage multiple branches without altering the main workspace. The tool smartly selects directories by preferring local folders, automates worktree creation, and runs post-setup checks for environment readiness.

Does setting up a git worktree require manual environment configuration?

No manual environment configuration is required. The tool features automatic project-name detection and optional environment setup steps to quick-start feature work, ensuring your isolated git worktree is ready for development immediately after creation.