What happens to the temporary branches created by the skill?

The skill includes specialized cleanup operations that force-remove the worktree directories and delete the associated temporary branches to keep your repository clean.

Can I customize where the worktrees are stored?

Yes, while it defaults to a temporary system directory to avoid cluttering your project folder, the base path can be configured within the script logic.

Why use Git worktrees instead of just branches?

Git worktrees allow you to have multiple branches checked out in different directories simultaneously. This is essential for parallel AI workers to run and test code without interfering with each other's file system or state.

Does it support environment variables?

Yes, it automatically detects and copies standard environment files like .env and .env.local to ensure the worker environment matches your development setup.

How does this skill handle project dependencies?

It uses an optimized strategy that symlinks the main node_modules folder to the worker directory, which is significantly faster than running a fresh install for every worker.

Worktree Manager

Name: Worktree Manager
Author: ponderingBGI

byponderingBGI

•

开发者工具

Automates the management of isolated Git worktrees for parallelized development workflows and autonomous agent environments.

Worktree Manager is a specialized utility designed for the ralph-loop++ framework to facilitate parallel code optimization by creating isolated worker environments. It streamlines the complex process of managing multiple Git worktrees, handling everything from unique branch generation and environment variable synchronization to optimized dependency management via node_modules symlinking. This skill ensures that multiple AI workers can operate on the same codebase simultaneously without file system conflicts, while providing robust cleanup routines to maintain a pristine repository state after tasks are completed.

主要功能

01Optimized dependency handling using symlinks to speed up worker initialization

02Automated creation of isolated Git worktrees with unique session-based branch naming

031 GitHub stars

04Built-in error handling for path conflicts and dirty worktree states

05Intelligent environment file synchronization across worker environments

06Comprehensive session-wide cleanup of temporary worktrees and branches

使用场景

01Managing complex Git workflows that require multiple branches to be checked out simultaneously

02Creating temporary sandboxed environments for safe, concurrent testing of code changes

03Scaling autonomous code optimizations across multiple parallel AI agents

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ponderingbgi/ralph-loop-pp worktree-manager

For use in Claude.ai and ChatGPT

Download Skill