worktree-management

What problem does it solve?

Managing multiple development branches often leads to environment conflicts, port clashes, and complex setup. This skill automates the creation and management of Git worktrees, providing completely isolated development environments with dedicated Docker services and browser automation, allowing you to work on multiple features or bug fixes simultaneously without interference.

Core Features & Use Cases

• Automated Worktree Creation: Instantly sets up new Git worktrees with unique Docker Compose configurations and auto-allocated ports.
• Isolated Browser Automation: Ensures each worktree has its own browser profiles and debugging ports, preventing conflicts during parallel E2E testing.
• Conflict-Free Development: Automatically handles port allocation, environment file copying, and Docker service isolation, so you can switch contexts seamlessly and avoid setup headaches.
• Use Case: Need to work on a new feature while a critical bug fix is in progress? Create a worktree for each. This skill ensures both environments run independently, with their own databases and browser sessions, eliminating setup headaches and context switching friction.

Quick Start

Example: Create a new worktree for a feature

@worktree create feature-user-export

Example: Create a worktree and start its services

@worktree create docs-api --branch=docs/api-documentation --start-services

Example: List all active worktrees

@worktree list