Fogalomtár › Fejlesztői alapszavak
worktree
angolul: git worktree
A worktree ugyanannak a programkódnak egy külön mappában megnyitott további munkapéldánya, így egyszerre több feladaton lehet dolgozni anélkül, hogy azok összekeverednének.
Érthetően
Képzeld el, hogy egy vastag kéziraton dolgozol, és egyszerre két fejezetet kellene átírnod. Ha csak egy asztalod van, minden váltásnál össze kell pakolnod az egyik fejezet lapjait, hogy elővehesd a másikat. A worktree olyan, mintha kapnál egy második asztalt: mindkét fejezet nyitva maradhat, a kézirat mégis ugyanaz az egy marad.
A programozók a Git nevű verziókezelővel követik a kód változásait. Alapesetben egy projekthez egy munkamappa tartozik, és abban egyszerre csak egy változat (ág) lehet elöl. A worktree-vel ugyanahhoz a projekthez több mappát nyithatsz, mindegyikben más ággal.
Az AI-korszakban azért lett hirtelen fontos, mert gyakran több kódoló agent dolgozik egyszerre ugyanazon a projekten. Ha három agent ugyanabban a mappában írná át a fájlokat, egymás munkáját rontanák el. Ha mindegyik saját worktree-t kap, nyugodtan dolgozhat, és a kész eredményt a végén lehet összefésülni.
Hogyan működik
- A projektnek van egy közös tárolója (repó), amely a kód teljes történetét őrzi. Ebből mindig csak egy van.
- Egy paranccsal (git worktree add) új mappát kérsz, és megmondod, melyik ág legyen benne. A Git oda kiteszi a fájlok megfelelő változatát.
- Az új mappában ugyanúgy szerkeszthetsz, tesztelhetsz és menthetsz, mint az eredetiben. Amit itt módosítasz, az a többi mappában nem látszik.
- A mentések (commitok) a közös tárolóba kerülnek, ezért a történet nem másolódik le többször, és a mappák tudnak egymás ágairól.
- Ha a feladat kész, az ágat beolvasztod a fő változatba, a feleslegessé vált worktree-t pedig törlöd.
Példa a mindennapokból
Megkérsz egy kódoló agentet, hogy építsen új funkciót a webshopodba, közben egy másik agent egy sürgős hibát javít. Mindkettő külön worktree-ben dolgozik, így nem írják felül egymás fájljait, te pedig a végén egyenként nézed át és fogadod el a munkájukat.
Kit érint
Gyakori félreértés
Korlátok és kockázatok
- Ugyanaz az ág alapesetben nem lehet egyszerre két worktree-ben megnyitva, ezért minden párhuzamos feladatnak saját ág kell.
- Csak a fájlokat választja szét: az adatbázis, a hálózati portok és a külső szolgáltatások közösek maradnak, így az agentek ott még zavarhatják egymást.
- A verziókezelésből kihagyott fájlok (például jelszavakat tartalmazó beállítások, telepített csomagok) nem kerülnek át az új mappába, ezeket ott külön be kell állítani.
- Az ütközéseket nem szünteti meg, csak elhalasztja: ha két agent ugyanazt a kódrészt írta át, az összefésüléskor valakinek döntenie kell.
Hasonló, de nem ugyanaz
- ág (branch) – Az ág a kód egy változatának neve a történetben, a worktree pedig az a mappa, ahol egy ilyen változat fájljai ténylegesen ki vannak terítve.
- klónozás (git clone) – A klón a teljes tároló önálló másolata saját történettel, a worktree viszont ugyanarra a közös tárolóra épülő további munkamappa.
- homokozó (sandbox) – A homokozó biztonsági elzárás, amely korlátozza, mihez fér hozzá egy program, a worktree viszont csak a fájlokat rendezi külön mappába, védelmet nem ad.
Kapcsolódó fogalmak
Röviden a története
A Git verziókezelőt Linus Torvalds indította el 2005-ben. A worktree parancs a 2015-ben megjelent 2.5-ös változattal került bele, és sokáig kevesek által ismert haladó funkció volt, amíg a párhuzamosan dolgozó kódoló agentek széles körben ismertté nem tették.
Hol tart most
2026 végén a Git régóta stabil, beépített része, és több AI-kódolóeszköz magától hoz létre worktree-t az agentjei számára. A fejlesztők körében a párhuzamos agentmunka egyik megszokott megoldása.
A hírekben
- A GitHub nyílt forráskódúvá tette a Replica prototípuskészítőt; a JetBrains ThinkRail IDE-t mutat2026. okt. 28. · Kód
Más nevei
worktree · git worktree · work tree · working tree · linked worktree · munkafa · Git-munkafa
Források
A szócikk gépi szerkesztéssel készült és gépi szakmai lektoráláson ment át; a „hírekben” rész az Agent Age sztorijaiból automatikusan frissül.