Does this work with any programming language?

Yes, while it has auto-detection for ecosystems like Node.js and Python, you can manually configure any build or start command in the .claude/worktree.json configuration file.

Is it safe for database-backed applications?

The skill includes specific Claude rules that instruct the agent to avoid running database migrations that could break other active worktrees sharing the same database.

Will this affect my main project directory?

No, the skill creates the workspace in a separate sibling directory, keeping your main checkout clean and unaffected by the parallel branch work.

How does it handle port conflicts?

The skill can use 'Portless' for named local domains or automatically calculate port offsets based on the number of existing worktrees to ensure no two services clash.

What is a Git worktree?

A Git worktree allows you to have multiple branches of the same repository checked out in different directories simultaneously, sharing the same local history and object database.

Parallel Worktree Workspace

Name: Parallel Worktree Workspace
Author: JoaquinCampo

byJoaquinCampo

0•

Developer Tools

Creates isolated git worktree environments for parallel branch development in monorepos with auto-configured services and environment variables.

This skill automates the complex process of setting up parallel development environments within monorepos using Git worktrees. It eliminates the friction of switching branches by creating a dedicated workspace folder where multiple services can run simultaneously without port conflicts. The skill intelligently detects project configurations, manages service dependencies through automatic environment variable patching, and generates convenient lifecycle scripts for starting, stopping, and cleaning up workspaces, allowing developers to work on features or code reviews in complete isolation.

Key Features

010 GitHub stars

02Automated git worktree creation for isolated branch development

03Lifecycle script generation (start.sh, stop.sh, cleanup.sh) for easy workspace management

04Dynamic environment variable patching for cross-service communication

05Smart project detection for Node.js, Python, and Makefile-based services

06Automatic port conflict resolution and Portless integration for stable URLs

Use Cases

01Working on a hotfix without stashing or interrupting progress on a long-running feature branch.

02Reviewing multiple Pull Requests simultaneously by running them in separate isolated workspaces.

03Developing microservices in a monorepo where services need to talk to each other via auto-wired URLs.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joaquincampo/workspaced-worktrees worktree

For use in Claude.ai and ChatGPT

Download Skill