LevwTech

LevwTech / worktree-compose

Public

Zero-config Docker Compose isolation for git worktrees

worktree-compose.com
14
1
100% credibility
Found Feb 24, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

worktree-compose is a zero-config CLI tool that automatically isolates Docker Compose setups across Git worktrees by assigning unique ports, syncing files, and managing containers.

How It Works

1
🔍 Discover the helper

You learn about a simple tool that lets you run multiple copies of your project at the same time without them interfering with each other.

2
📥 Add it to your project

You bring the tool into your main project folder with an easy one-time step.

3
📂 Set up separate spaces

You create dedicated folders for each feature or experiment you want to work on.

4
🚀 Launch isolated playgrounds

You give the command to start, and each space springs to life with its own private servers, storage, and access points – no overlaps or clashes.

5
📋 Check your overview

You see a friendly list of all spaces, showing which are active, their web links, and unique connection spots.

6
Manage your spaces
🔄
Refresh one

Restart a space to update it with fresh changes.

📤
Merge ideas

Bring updates from one space into your main work area.

🛑
Pause some

Stop spaces you're not using to free up resources.

🎉 Work freely and happily

Everything runs smoothly side by side, letting you build, test, and combine features effortlessly without mess or frustration.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is worktree-compose?

worktree-compose is a TypeScript CLI tool for zero-config Docker Compose isolation across git worktrees. It auto-assigns unique ports, syncs infra files like Dockerfiles and .env, and spins up independent containers, databases, and networks per worktree—solving port clashes and shared state when running multiple branches side-by-side. Install via npm, then use commands like `npx wtc start` to launch stacks or `wtc list` to check status with URLs and ports.

Why is it gaining traction?

It stands out with true zero-config setup: just use `${VAR:-default}` in your docker-compose.yml ports, and it handles everything else—port remapping to 20k+ ranges, project name prefixing for isolation, and even a `promote` command to cherry-pick changes from one worktree to another without merges. The MCP server lets AI agents control stacks programmatically, perfect for zenless zone zero config github workflows with parallel agents. No more manual port juggling or compose file tweaks.

Who should use this?

Teams running git worktrees for feature branches, where devs or AI agents need isolated Docker stacks without conflicts—think backend devs testing APIs across branches, or solo experimenters with multiple local environments. Ideal for monorepos with compose, docker, postgres/redis services exposing ports via env vars. Skip if you avoid worktrees or prefer Kubernetes.

Verdict

Try it if git worktrees and Docker Compose are your jam—solid docs and CLI make it dead simple despite 10 stars and 1.0% credibility score signaling early maturity. Low adoption means watch for edge cases, but MIT license and Node 18+ req keep barriers low.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.