worktree-setup

Scan a project to generate a .worktree.json file for git worktree port configurations.

2|Updated Mar 14, 2026

Search Tags:#git #development workflow #configuration #worktree #port management #docker

Ready to run

npx skills add https://github.com/elijahmurray/vandra-dev --skill worktree-setup-elijahmurray

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: worktree-setup
Source: https://github.com/elijahmurray/vandra-dev/tree/main/skills/worktree-setup
Command: npx skills add https://github.com/elijahmurray/vandra-dev --skill worktree-setup-elijahmurray

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of a .worktree.json file, simplifying the management of ports and configurations across multiple git worktrees in a project.

Core Features & Use Cases

Automated Configuration: Scans your project to detect services, frameworks, and port variables to generate a .worktree.json file.
Port Management: Establishes a clear port topology for isolated development environments.
Use Case: When starting a new feature branch that requires its own set of running services, use this Skill to automatically configure the necessary port assignments and environment variables, preventing port conflicts.

Quick Start

Run the worktree setup skill to scan the current project and generate a .worktree.json file.

Frequently Asked Questions about worktree-setup

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

FAQPage Schema

How do I manage git worktree port configurations automatically?▼

You can automatically generate a .worktree.json file by scanning your project for package.json services, framework dependencies, .env files, and docker-compose.yml. This process establishes base ports and database configurations to prevent conflicts across isolated worktrees.

What is a .worktree.json file used for in a development workflow?▼

A .worktree.json file defines port assignments and environment variables for managing multiple git worktrees within a single project. It prevents port conflicts by establishing a clear topology for isolated development environments running parallel feature branches.

How do I prevent port conflicts when running multiple git worktrees?▼

You prevent port conflicts by generating a configuration file that assigns unique port topologies to each isolated development environment. Scanning project files like docker-compose.yml and .env automatically establishes distinct base ports and database configurations for parallel worktrees.

Does the worktree setup process detect services from docker-compose.yml?▼

Yes, the worktree setup process detects services from docker-compose.yml, package.json, framework dependencies, and .env files. It extracts base ports and database configurations from these sources to accurately generate the worktree configuration file.

Can I review the detected port configurations before the .worktree.json file is written?▼

Yes, you can review detected configurations before the file is written. The setup process scans your project to detect services and presents these findings for user review, ensuring the correct base ports and database configurations are established before generating the file.

When do I need to generate a worktree configuration file?▼

You need to generate a worktree configuration file when starting a feature branch that requires its own running services. This automatically configures necessary port assignments and environment variables, preventing conflicts across isolated development environments.