Git worktree: fondasi untuk menjalankan banyak agen AI tanpa konflik

Kamu menjalankan dua agen di repo yang sama. Yang satu mengedit package.json, yang satunya juga. Tiga puluh detik kemudian kode kamu jadi kacau dan tidak ada yang bisa di-merge.

Itu bukan bug di agen kamu. Masalahnya, mereka semua bekerja di folder yang sama.

Solusinya adalah tool yang sudah ada di Git bertahun-tahun tapi hampir tidak ada yang pakai: git worktree.

Masalahnya: 3 agen, 1 repo, merge yang mustahil

Repo Git biasa itu satu folder dengan satu branch yang di-checkout pada satu waktu. Kamu kerja di main, kamu pindah branch, seluruh folder ikut berubah.

Sekarang masukkan tiga agen otonom ke folder itu. Mereka menulis di waktu bersamaan. Agen A membuat sebuah file, agen B menjalankan git checkout untuk mulai dari bersih dan menghapus pekerjaan A yang sedang berlangsung. Hasilnya: file setengah jadi, index yang berantakan, dan konflik yang lebih lama dibereskan daripada kalau kamu coding sendiri dari awal.

Paralelisme menghemat waktu kamu hanya kalau agen-agennya tidak saling bersentuhan.

Apa itu git worktree

Worktree adalah folder kerja kedua yang terhubung ke repo yang sama.

History sama, remote sama, tapi tiap worktree punya branch sendiri yang di-checkout dan file sendiri di disk. Kamu bisa punya lima sekaligus berdampingan, masing-masing di branch berbeda, tanpa saling mengganggu.

Satu .git, beberapa workspace. Cuma itu.

Satu worktree per agen, dalam praktik

Begini setup-nya. Dari repo kamu:

git worktree add ../project-auth -b feature/auth
git worktree add ../project-billing -b feature/billing
git worktree add ../project-export -b feature/export

Kamu baru saja membuat tiga folder, masing-masing di branch-nya sendiri. Kamu jalankan satu agen di tiap folder:

cd ../project-auth && claude
cd ../project-billing && codex

Tiap agen punya folder-nya, branch-nya, file-nya. Agen auth tidak akan pernah melihat apa yang dikerjakan agen billing. Tidak mungkin ada tabrakan.

Saat sebuah fitur sudah siap, kamu review branch-nya lalu merge. Setelah itu kamu bersih-bersih:

git worktree remove ../project-auth

Folder-nya hilang, branch-nya tetap ada di history kamu. Bersih.

3 jebakan yang perlu kamu tahu

Jebakan pertama: file pusat yang dipakai bersama. Kalau dua fitur sama-sama harus menyentuh routes.ts yang sama atau skema database yang sama, worktree tidak menyelamatkanmu, kamu tetap akan kena konflik saat merge. Satu agen menyentuh file yang dipakai semua orang, yang lain menunggu atau cari jalan memutar.

Kedua: branch yang melenceng. Sementara agen-agen kamu bekerja, main terus jalan. Tiga hari kemudian branch kamu ketinggalan dan merge jadi menyakitkan. Rebase lebih awal dan sesering mungkin, atau buat sesi yang pendek.

Ketiga: lupa bersih-bersih. Tiap worktree itu folder beneran di disk kamu. Sepuluh sehari tanpa dibersihkan, dan folder induk kamu jadi tidak terbaca. git worktree list menampilkan apa saja yang masih nyangkut, git worktree prune membuang yang sudah mati.

Pertanyaan sebenarnya: siapa yang mengawasi kelima folder itu?

Worktree menyelesaikan tabrakan file. Tapi worktree tidak menyelesaikan beban pikiran kamu.

Kamu punya lima folder, lima agen, lima terminal. Yang mana yang menunggu review kamu? Yang mana yang baru saja selesai sepuluh menit lalu waktu kamu lagi sibuk hal lain? Yang mana yang crash?

Di situlah satu worktree per agen mencapai batasnya kalau kamu tetap di terminal. Kamu sudah menyelesaikan konflik teknisnya, tapi kamu malah menggandakan jendela yang harus diawasi.

AgentsRoom menempatkan tiap agen di sebuah tile, lengkap dengan status dan warnanya, tidak peduli di worktree mana ia berjalan. Agen yang sedang menunggu berubah merah dan memanggil kamu. Baca cara menjalankan 3 sampai 8 agen secara paralel tanpa kehilangan kendali untuk metode lengkapnya sebagai pelengkap worktree.

Yang perlu kamu ingat

Satu agen, satu worktree, satu branch. Itu aturan dasar kerja multi-agen yang serius.

Perintahnya muat dalam tiga baris, manfaatnya langsung terasa: agen-agen kamu berhenti saling menimpa. Tambahkan satu tampilan yang memberitahu kamu mana yang butuh perhatianmu, dan kamu benar-benar bisa memegang lima pekerjaan paralel tanpa kehilangan akal.