worktree-setup

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.

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.

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.

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.

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.

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.