git-worktree

Create and configure git worktrees with branch naming and verification.

1|Updated Oct 26, 2025
One-click install
npx skills add https://github.com/gosu-code/claude-plugin --skill git-worktree-gosu-code
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: git-worktree
Source: https://github.com/gosu-code/claude-plugin/tree/main/plugins/gosu-mcp-core/skills/git-worktree
Command: npx skills add https://github.com/gosu-code/claude-plugin --skill git-worktree-gosu-code

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Automate the creation and configuration of git worktrees to enable isolated development environments and faster task onboarding.

Core Features & Use Cases

  • Generate a unique worktree path and branch name from a task prompt
  • Resolve a base branch from local or remote repositories and attach a new worktree via git worktree
  • Copy git-ignored files and directories to the new worktree to speed up setup
  • Create symlinks for local settings and copy a plan file for agent-based workflows
  • Verify the new worktree's integrity and run environment-specific checks

Quick Start

Run the create_git_worktree.py script with a task prompt to generate a new worktree and an associated feature branch

Frequently Asked Questions about git-worktree

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

FAQPage Schema
How do I automate git worktree creation for isolated development environments?▼

You can automate git worktree creation by running a Python script that resolves base branches, generates unique paths, and attaches new worktrees to establish isolated development environments automatically.

What is the best way to copy git-ignored files when setting up a new git worktree?▼

The best way to copy git-ignored files during git worktree setup is using an automated script that selectively copies necessary directories and creates symlinks for local settings to speed up environment configuration.

Do I need Python 3 to create and configure git worktrees automatically?▼

Yes, you need Python 3 and the git CLI to run the automation script that manages worktrees, resolves base branches, and performs post-creation verification across varied project setups.

Can I resolve a remote base branch when attaching a new git worktree?▼

Yes, the automation script can resolve a base branch from either local or remote repositories before attaching a new git worktree to ensure your isolated environment is synced correctly.

How does post-creation verification work for newly generated git worktrees?▼

Post-creation verification checks the new git worktree's integrity and runs environment-specific checks to ensure the isolated development environment is fully functional and correctly configured.

When should I use git worktrees instead of standard git branches for task onboarding?▼

You should use git worktrees instead of standard git branches when you need isolated development environments with separate directories, allowing faster task onboarding without switching branches in a single working directory.