Can I use this with monorepos?

Yes, it is designed specifically for monorepos. It can manage multiple sub-repositories simultaneously, ensuring all services are on the correct branch and can communicate via patched environment variables.

How do I remove a worktree when finished?

Every generated workspace includes a cleanup.sh script that automatically stops running servers, removes the worktrees from Git, and deletes the temporary workspace directory.

What is a Git worktree workspace?

It is an isolated directory linked to your main repository that contains a specific branch, allowing you to work on multiple features concurrently without performing a 'git checkout' in your primary working directory.

How does this skill handle port conflicts?

The skill automatically detects busy ports and increments assigned ports to avoid conflicts, or integrates with Portless to provide stable, named local URLs.

Does it support dependency caching?

Yes, it can clone directories like .venv or vendor using fast copy-on-write (APFS) or hardlinks (Linux) to significantly speed up workspace initialization.

Isolated Worktree Workspace

Name: Isolated Worktree Workspace
Author: JoaquinCampo

byJoaquinCampo

0•

Developer Tools

Manages isolated Git worktree workspaces for parallel branch development with auto-wired environments and lifecycle scripts.

This skill automates the creation of isolated development environments using Git worktrees, allowing Claude Code to work on multiple feature branches simultaneously without interfering with your main checkout. It intelligently detects repository configurations, handles port management or Portless routing, clones dependency caches for speed, and generates standardized scripts to start, stop, and clean up the entire workspace. It ensures a consistent, conflict-free environment by auto-patching environment variables and providing the AI agent with clear operational rules for the specific workspace.

Key Features

01Generated lifecycle scripts (start, stop, cleanup) for seamless server orchestration.

02Automated Git worktree creation for isolated parallel branch development.

030 GitHub stars

04Intelligent environment patching with Portless support or automatic port conflict resolution.

05Auto-detection of project configurations, install commands, and service relationships.

06Fast workspace setup via copy-on-write dependency cloning for APFS and Linux.

Use Cases

01Developing multiple features simultaneously without the overhead of constant branch switching.

02Running isolated Claude Code instances on different branches with dedicated, non-conflicting server ports.

03Managing complex monorepo environments where multiple services require synchronized branch checkouts.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joaquincampo/workspaced-worktrees worktree

For use in Claude.ai and ChatGPT

Key Features

01Generated lifecycle scripts (start, stop, cleanup) for seamless server orchestration.

02Automated Git worktree creation for isolated parallel branch development.

030 GitHub stars

04Intelligent environment patching with Portless support or automatic port conflict resolution.

05Auto-detection of project configurations, install commands, and service relationships.

06Fast workspace setup via copy-on-write dependency cloning for APFS and Linux.

Use Cases

01Developing multiple features simultaneously without the overhead of constant branch switching.

02Running isolated Claude Code instances on different branches with dedicated, non-conflicting server ports.

03Managing complex monorepo environments where multiple services require synchronized branch checkouts.