Git Worktrees
Työskentele usealla haaralla samanaikaisesti ilman stashausta – jokainen omassa kansiossaan, ja vaihdat niiden välillä tilapalkista.
Worktree-työpuut ratkaisevat yhden arkisen kehitystyön ärsyttävimmistä ongelmista: haaraa pitää vaihtaa kesken työn. Worktreen kanssa et vaihda haaraa – avaat toisen haaran toiseen kansioon ja työskentelet molemmissa yhtä aikaa.
Mikä on Git worktree?
Normaalisti Git-repositoriolla on yksi työhakemisto eli kansio, jossa tiedostosi sijaitsevat. Kerrallaan siinä kansiossa on checkoutattuna täsmälleen yksi haara. Jos haluat tutkia toista haaraa, sinun täytyy ottaa se käyttöön checkoutilla, mikä korvaa tiedostosi kyseisen haaran versiolla. Jos nykyisiä muutoksiasi ei ole commitoitu, ne täytyy ensin stashata, mikä on ärsyttävää ja virhealtista.
Worktree on toinen (tai kolmas tai neljäs) työhakemisto, joka on linkitetty samaan Git-repositorioon. Jokaisella worktreellä on oma checkoutattu haaransa, oma tiedostotilansa ja oma historiansa. Ne kaikki jakavat saman .git-kansion ja commit-historian – ne ovat vain eri ikkunoita samaan repositorioon.
Konkreettinen esimerkki: tekoälyagenttisi on puolivälissä uuden ominaisuuden rakentamista haaralla feature/payments. Kollega pyytää sinua tarkastamaan hänen PR:nsä haaralla fix/login-bug. Sen sijaan että stashaisit ominaisuustyösi, luot haaralle fix/login-bug worktreen erilliseen kansioon. Tarkastat PR:n siellä, ja ominaisuushaarasi pysyy koskemattomana alkuperäisessä kansiossaan.
Luo worktree
- Avaa Git-paneeli – paina Cmd+G
- Napsauta paneelin yläreunasta Worktrees-välilehteä
- Napsauta + Add Worktree
- Valitse haara – joko olemassa oleva haara listasta tai kirjoita uuden haaran nimi sen luomiseksi
- Valitse kansiosijainti uudelle worktreelle (oletuksena 1DevTool ehdottaa kansiota nykyisen projektikansiosi viereen)
- Napsauta Create – 1DevTool suorittaa komennon
git worktree addja avaa uuden worktree-kansion aktiivisena työtilana
Uusi worktree näkyy nyt Worktrees-välilehdellä pää-worktreen rinnalla.

Worktree-terminaalit
Kun 1DevTool luo worktreen, se avaa myös uuden terminaalin, joka on rajattu kyseisen worktreen kansioon. Haaran nimi näkyy terminaalin otsikossa, joten tiedät aina, missä haarassa työskentelet.
Terminaalissa oleva tekoälyagenttisi toimii worktree-kansiossa – se voi lukea ja kirjoittaa tiedostoja, ajaa komentoja ja tehdä muutoksia kyseisellä haaralla tietämättä muista haaroistasi tai häiritsemättä niitä.


Voit ajaa agentteja useissa worktreissä samanaikaisesti. Yksi agentti työstää maksuominaisuutta, kun toinen korjaa bugia toisella haaralla. Molemmilla agenteilla on oma terminaali, oma tiedostokonteksti ja oma haara – ne eivät voi mennä keskenään ristiin.
Vaihda worktreetä tilapalkista
Kun projektilla on linkitettyjä worktreitä, tilapalkki näyttää aktiivisen checkoutin haaramerkin vieressä – sen värin sekä primary-, locked- ja dirty-merkinnät – ja mahdollistaa niiden välillä vaihtamisen avaamatta Git Clientia.

Kaksi asiaa varmistaa, että vaihto päätyy sinne, minne odotat:
- Worktreehen kuuluva terminaali tulee esiin. Et jää toisen checkoutin välilehdelle – yleisin syy siihen, että komento ajetaan väärässä puussa.
- Tyhjä worktree kertoo olevansa tyhjä. Checkout, jossa ei ole näkyviä terminaaleja, näyttää tekstin No terminal in this worktree ja Add terminal in this worktree -painikkeen sen sijaan, että näkyisi jäännöspaneeli jostain muualta.
Tiedostoselain seuraa myös aktiivista worktreetä, joten selaamasi puu vastaa puuta, jossa komentosi ajetaan.
Poista worktree
Kun worktree ei ole enää tarpeen – PR on yhdistetty, haara poistettu – voit poistaa sen siististi:
- Avaa Git-paneeli ja siirry Worktrees-välilehdelle
- Etsi worktree, jonka haluat poistaa
- Napsauta sen vieressä olevaa roskakorikuvaketta
- Vahvista poisto
Tämä poistaa worktree-kansion ja poistaa sen rekisteröinnin Gitistä (vastaa komentoa git worktree remove). Itse haaraa ei poisteta – vain työhakemisto. Voit luoda worktreen uudelleen myöhemmin tarvittaessa.
Vinkki: Käytä worktreitä ajaaksesi tekoälyagenttiasi ominaisuushaarassa ja pitääksesi mainin vakaana. Agentti ei voi vahingossa rikkoa main-haaraasi.
Worktreet ovat yksi Gitin vähiten hyödynnetyistä ominaisuuksista. Tekoälyavusteisessa kehityksessä – jossa agentti voi tehdä kymmeniä tiedostomuutoksia minuuteissa – mahdollisuus eristää kunkin agentin työ omaan haaraansa ja kansioonsa on merkittävä turvaverkko.