worktree

Create and manage isolated git worktrees with a bundled manager script.

1|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/mopeyjellyfish/flywheel --skill worktree-mopeyjellyfish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree
Source: https://github.com/mopeyjellyfish/flywheel/tree/main/skills/worktree
Command: npx skills add https://github.com/mopeyjellyfish/flywheel --skill worktree-mopeyjellyfish

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Isolated git worktrees enable parallel development and isolated reviews without polluting the main working copy.

Core Features & Use Cases

  • Creates and manages dedicated worktrees under .worktrees with consistent naming and safe cleanup.
  • Automates environment file handling by policy (templates vs. real env files) and ensures ignores are configured.
  • Provides commands for create, list, path lookup, copy-env, and cleanup to support end-to-end workflow isolation.

Quick Start

Create a new isolated worktree for a feature branch using the built-in manager.

Frequently Asked Questions about worktree

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

FAQPage Schema
How do I use git worktrees for parallel development without polluting the main branch?

Git worktrees create isolated working copies under a .worktrees directory, allowing parallel feature development and isolated code reviews without affecting the main repository's working state.

What is the best way to manage multiple git branches simultaneously?

Managing multiple git branches simultaneously is streamlined by creating dedicated worktrees with consistent naming, enabling you to switch contexts instantly without stashing changes.

How do I copy environment files when creating a new git worktree?

You copy environment files using a copy-env command that applies an environment copy policy, distinguishing between templates and real env files to safely configure the new worktree.

Does this worktree manager automatically update .gitignore for isolated branches?

Yes, the worktree manager automatically updates .gitignore to ensure the generated .worktrees directory and sensitive environment files are properly excluded from version control.

How do I safely clean up isolated git worktrees after finishing a feature?

You safely clean up isolated git worktrees using an on-demand cleanup command, which removes the dedicated working directory and its associated files without damaging the main repository.

Can I use git worktrees for experimental branches in a single repository?

Yes, you can use git worktrees for experimental branches in a single repository, providing a safe, isolated sandbox to test changes before merging them back into the main codebase.