worktree

Automate Git worktree creation while syncing gitignored config files across platforms via Python script.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/RoukSonix/claude-code-octopus --skill worktree-rouksonix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree
Source: https://github.com/RoukSonix/claude-code-octopus/tree/main/.opencode/skills/worktree
Command: npx skills add https://github.com/RoukSonix/claude-code-octopus --skill worktree-rouksonix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of setting up parallel development environments by creating new Git worktrees and automatically syncing essential configuration files, ensuring consistency across branches.

Core Features & Use Cases

  • Automated Worktree Creation: Generates new Git worktrees with customizable paths and branch names.
  • Intelligent File Syncing: Copies important gitignored files (like .env, local configs, IDE settings) while excluding large dependencies (like node_modules).
  • Cross-Platform Compatibility: Works seamlessly on macOS, Linux, and Windows using a Python script.
  • Use Case: When you need to quickly switch to a new feature branch or work on a bug fix without disrupting your current work, this Skill sets up a clean, isolated environment with all your necessary local configurations pre-populated.

Quick Start

Use the worktree skill to create a new git worktree at the path '../my-feature' for the 'develop' branch.

Frequently Asked Questions about worktree

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

FAQPage Schema
How do I create a git worktree and sync gitignored configuration files like .env?

To create a git worktree and sync configuration files, this Skill automates the generation of parallel development environments while copying essential gitignored files like .env and local settings into the new branch path.

Does git worktree creation work on Windows, macOS, and Linux?

Git worktree creation works seamlessly across macOS, Linux, and Windows using a cross-platform Python script, ensuring consistent development environment setup and configuration syncing regardless of the operating system.

What is the best way to set up an isolated git branch without copying large dependencies?

The best way to set up an isolated git branch is using automated worktree creation, which intelligently syncs necessary local configuration files while explicitly excluding large directories like node_modules.

How do I generate a new feature branch and validate its name for git worktree setup?

You can generate a new feature branch and validate its name during worktree setup, as the Skill handles default path generation and validates branch names automatically before creating the isolated environment.

Can I sync IDE settings and local configs when switching to a new git worktree?

You can sync IDE settings and local configs when switching to a git worktree, as the Skill automatically copies specified configuration files to ensure consistency across parallel development branches.

Why does my development environment break when switching branches without git worktree?

Your development environment breaks because switching branches without git worktree overwrites local configurations, whereas creating a worktree isolates the environment while pre-populating the necessary gitignored settings.