git-worktree-manager

Git Worktree Manager to narzędzie dla deweloperów pracujących na kilku gałęziach jednocześnie. Automatycznie izoluje każde środowisko robocze, przydzielając unikalne porty, synchronizując pliki .env i czyniąc każde worktree niezależnym. Idealne dla zespołów używających wielu agentów lub sesji terminalowych — eliminuje ręczne zarządzanie portami i czyszczenie starych worktrees. Wspiera wykrywanie zmian, instalację zależności oraz bezpieczne usuwanie scalonych gałęzi.

1. Przygotuj repozytorium Git z gałęzią główną (np. main). Upewnij się, że masz zainstalowany Python i dostęp do skryptu worktree_manager.py z repozytorium umiejętności.

2. Uruchom menedżer, podając nazwę nowej gałęzi i worktree. Przykład: python scripts/worktree_manager.py --repo . --branch feature/nowa-funkcja --name wt-feature --base-branch main. Skrypt utworzy gałąź, jeśli nie istnieje, i przygotuje worktree.

3. Dodaj flagę --install-deps, jeśli chcesz, aby menedżer automatycznie zainstalował zależności na podstawie pliku blokady (np. package-lock.json). Flaga --format text wyświetli wynik w czytelnym formacie.

4. Przejrzyj wygenerowaną mapę portów — każde worktree otrzyma unikalny port, aby uniknąć konfliktów. Menedżer skopiuje też pliki .env* z głównego repozytorium do nowego worktree.

5. Uruchom aplikację w worktree, używając przydzielonych portów. Każde środowisko pracuje niezależnie bez wpływu na inne gałęzie.

6. Gdy skończysz pracę, użyj menedżera do czyszczenia: skrypt wykryje scalonych gałęzie i bezpiecznie usunie stare worktrees, zamiast ręcznego rm -rf.