Git worktree je funkce verzovacího systému Git, která umožňuje pracovat na více větvích jednoho projektu současně - každá ve svém vlastním adresáři na disku. Bez worktree platí pravidlo: jeden projekt, jedna aktivní větev. Worktree toto omezení odstraňuje.
Jak to funguje
Každý worktree je samostatný adresář s vlastním stavem kódu, ale sdílí společnou historii commitů s hlavním repozitářem. Vývojář tak má otevřených "více pracovních stolů" najednou - změna na jednom neovlivní ostatní.
Základní příkazy:
git worktree add -b hotfix ../hotfix-dir main # přidat nový worktree git worktree list # zobrazit všechny aktivní git worktree remove ../hotfix-dir # smazat po dokončení
Typické situace použití
Urgentní oprava bez přerušení práce. Vývojář pracuje na nové funkci a přijde kritická chyba na produkci. Bez worktree: odložit rozdělanou práci, přepnout větev, opravit, vrátit se. S worktree: otevřít nový adresář, opravit chybu tam, původní práce čeká nedotčena.
Code review se spuštěním. Ověření pull requestu kolegů vyžaduje někdy skutečné spuštění kódu - ne jen čtení. Worktree otevře PR ve druhém adresáři, aniž by vývojář opustil vlastní rozdělanou práci.
Paralelní AI agenti. V roce 2025-2026 se git worktree stal standardním nástrojem pro orchestraci více AI agentů najednou. Každý agent dostane vlastní izolovaný worktree a pracuje bez rizika přepsání souborů jiným agentem.
Rozdíl od git branch a git stash
Git branch je logická věc - ukazatel na commit. Git stash je dočasné odložení - hodí se pro minutové přerušení. Git worktree je fyzická věc - samostatný adresář na disku, vhodný pro hodinovou nebo denní paralelní práci.
Omezení
Stejnou větev nelze mít otevřenou ve více worktrees najednou. Soubory ignorované Gitem (například složka node_modules nebo .env) se do nového worktree nepřenáší - je nutné je znovu vybudovat. Podpora pro projekty se submoduly je označena jako experimentální.
Git worktree je dostupný od verze Git 2.5 (2015) a funguje na všech platformách včetně Windows.
Pavel Szabo
Programátor webů, eshopů a informačních systémů s více než 23 lety praxe. Pomáhám firmám i jednotlivcům s online podnikáním, automatizacemi a využitím AI v praxi.