Worktree Wizard
- 1 repo stars
- Updated February 8, 2026
- asabedia/worktree-wizard
worktree-wizard is a Git worktree and Docker isolation toolkit that assigns each branch its own slot, ports, and data directories so developers can run parallel stacks without configuration conflicts.
About
worktree-wizard is a Claude Code marketplace plugin that combines git worktrees with Docker port and data isolation so you can run multiple feature branches simultaneously without conflicts. The /wt-onboard wizard scans your project and generates labeled docker-compose.yml, justfile recipes, and hot-reload configs. Reach for it when context-switching between branches currently forces tearing down stacks or fighting port collisions.
- /wt-onboard scans stack and generates compose, justfile, and Dockerfiles
- Slot-based port and data isolation for up to nine concurrent worktrees
- wt-dev bootstraps agent-ready worktrees with TCP health checks
- Auto-detects npm, pnpm, poetry, uv, go, and cargo dependencies
Worktree Wizard by the numbers
- Data as of Jul 10, 2026 (Skillselion catalog sync)
/plugin marketplace add asabedia/worktree-wizardAdd your badge
Show developers this marketplace is listed on Skillselion. Paste this into your README.
| repo stars | ★ 1 |
|---|---|
| Last updated | February 8, 2026 |
| Repository | asabedia/worktree-wizard ↗ |
How do you work on multiple feature branches with docker compose up without port conflicts or tearing down your current stack?
Run parallel git worktrees with auto-offset Docker ports, isolated data dirs, and agent-ready health checks via /wt-onboard.
Who is it for?
Teams using git, just, and docker compose who frequently context-switch between parallel feature branches.
Skip if: Single-branch workflows or projects that do not use Docker for local services.
What you get
A ready worktree under .worktrees/ with offset host ports, isolated .docker-data/, and health-checked containers.
Plugins in this marketplace
1 plugin - install individually after you add the marketplace.
Recommended Marketplaces
FAQ
What does /wt-onboard generate?
It scans your codebase and produces docker-compose.yml with wt.* labels, a justfile, Dockerfiles, .wt-required-tools, and post-setup hooks.
How many concurrent worktrees are supported?
Up to nine slots by default, each offsetting host-mapped ports and optional data directories per service.
What prerequisites are required?
just >= 1.19, git, docker with docker compose, and optionally jq for improved YAML parsing.