What problem does it solve? Running multiple feature branches simultaneously often leads to port collisions, shared databases, and messy manual cleanup. This Skill standardizes Git worktree creation, port assignment, environment file syncing, and safe removal so each branch behaves like an independent local app. ## Core Features & Use Cases - Automated Worktree Setup: Create worktrees from new or existing branches, copy .env* files from the main repo, and optionally install dependencies based on detected lockfiles (npm, pnpm, yarn, bun, pip). - Deterministic Port Allocation: Assign non-conflicting app, database, and Redis ports per worktree using a base-plus-stride formula, persisted in .worktree-ports.json. - Safe Cleanup: Detect stale, dirty, and merged worktrees, then remove only those that are stale, clean, and merged into the base branch. - Use Case: A team running three agents on separate feature branches gives each agent its own worktree with isolated ports (3010/5442/6389, 3020/5452/6399, ...) so dev servers and databases never collide, then runs a weekly cleanup scan to prune merged work. ## Quick Start Ask the AI to create a new Git worktree for branch feature/new-auth named wt-auth based on main, with dependencies installed and ports allocated.
