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.