parallel-worktrees

Creates and manages git worktrees for parallel coding sessions across multiple branches.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill parallel-worktrees-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: parallel-worktrees
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/parallel-worktrees
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill parallel-worktrees-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long-running tests, builds, and CI pipelines leave developers idle, and switching branches mid-task disrupts uncommitted work. This Skill sets up isolated git worktrees so multiple coding sessions run in parallel without interfering with each other. ## Core Features & Use Cases - Worktree Creation and Cleanup: Add worktrees for feature, bugfix, or experiment branches and remove or prune them when finished. - Parallel Session Workflow: Run separate editor or AI sessions per worktree so tests, reviews, and development proceed simultaneously. - Claude Code Integration: Use claude -w for automatic worktree creation and cleanup, plus background task controls. - Use Case: While a test suite runs for several minutes on your main branch, open a second worktree on a bugfix branch and resolve an issue in a separate session, then clean up with git worktree prune. ## Quick Start Ask the assistant to create a git worktree for a new feature branch and show the commands to open and later clean up a parallel session.

Frequently Asked Questions about parallel-worktrees

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

FAQPage Schema
How do I work on multiple git branches at the same time?

Use git worktree add to create a separate working directory for each branch, such as git worktree add ../project-feat feature-branch. Each worktree is an isolated copy, so you can develop in one while tests run in another.

What is a git worktree and when should I use one?

A git worktree is an additional working directory linked to the same repository, letting you check out multiple branches simultaneously. Use one when blocked on tests or builds, comparing approaches, or reviewing code while developing.

How do I remove a git worktree safely?

First verify changes are committed with git -C ../worktree-path status, then run git worktree remove ../worktree-path. Finish with git worktree prune to clean up stale administrative entries.

Does Claude Code support git worktrees automatically?

Yes, running claude -w or claude --worktree auto-creates an isolated worktree and cleans it up afterward. Subagents also support isolation: worktree in their frontmatter.

What are the limitations of using multiple git worktrees?

Each worktree is a full working copy consuming disk space, and editing the same files in multiple worktrees can cause merge conflicts. You must also remember to remove and prune worktrees when finished.