Tutorial 15: Git Worktrees — Parallel Agents

Ini adalah bagian dari seri tutorial resmi Hermes Agent. Lihat semua tutorial

Bayangkan kamu punya satu dapur tapi dua koki. Kalau mereka berdua masak di meja yang sama, mereka pasti akan saling sikut, menumpahkan tepung, dan merusak masakan satu sama lain. Git worktree memberi setiap koki meja sendiri—dapur yang sama, tapi ruang kerja terpisah. Persis itulah yang fitur ini lakukan untuk agen AI-mu.

---

Kenapa Repot? Masalah dengan Satu Checkout

Hermes Agent memperlakukan folder tempat kamu menjalankannya sebagai root proyek. Kalau kamu menjalankan dua agen di folder yang sama, mereka berbagi semua file. Artinya:

• Agen A bisa menghapus file yang sedang diedit Agen B.
• Kamu tidak bisa tahu perubahan mana yang berasal dari eksperimen mana.
• Rollback jadi berantakan—undo dari satu agen bisa menghapus pekerjaan agen lain.

Worktree menyelesaikan ini dengan memberi setiap agen:

• Cabang (branch) sendiri (supaya perubahan tidak bentrok)
• Folder kerja sendiri (supaya file tidak bertabrakan)
• Riwayat checkpoint sendiri (supaya /rollback hanya memengaruhi agen itu saja)

---

Langkah 1: Buat Worktree (Perintah Dasar)

Dari repository utama kamu (yang berisi .git/ di dalamnya), jalankan:

git worktree add ../my-agent-folder -b my-feature-branch

Mari kita bedah:

• ../my-agent-folder – tempat folder baru akan dibuat (di luar repo utama kamu)
• -b my-feature-branch – membuat cabang baru untuk agen ini

Sekarang kamu punya salinan proyek yang segar dan terisolasi.

---

Langkah 2: Arahkan Hermes ke Worktree

Kamu bisa menggunakan worktree dengan dua cara:

Opsi A: CLI (paling sederhana)
Tinggal cd ke worktree dan jalankan Hermes di sana:

cd ../my-agent-folder
hermes chat

Opsi B: Gateway pesan (seperti Slack atau Discord)
Kalau kamu pakai gateway, edit ~/.hermes/config.yaml dan set terminal.cwd ke path worktree:

terminal:
  cwd: /path/to/my-agent-folder

Sekarang setiap pesan yang diterima agen itu akan diproses di dalam folder terisolasi tersebut.

---

Langkah 3: Jalankan Banyak Agen Secara Paralel

Buat worktree sebanyak yang kamu butuhkan:

git worktree add ../agent-experiment-1 -b exp-1
git worktree add ../agent-experiment-2 -b exp-2

Lalu mulai satu sesi Hermes di setiap folder. Mereka tidak akan pernah menyentuh file satu sama lain, dan masing-masing punya cabang sendiri untuk di-commit.

---

Langkah 4: Bersih-bersih Setelah Selesai

Saat eksperimen selesai, hapus worktree-nya:

git worktree remove ../agent-experiment-1
git branch -d exp-1

Perintah pertama menghapus folder; perintah kedua menghapus cabang. Repo utama kamu tetap bersih.

---

Poin Penting yang Perlu Diingat

• Worktree itu murah – mereka tidak menyalin seluruh repo, hanya file yang kamu butuhkan.
• Setiap agen punya riwayat /rollback sendiri – tidak ada lagi bencana undo antar-agen.
• Gunakan cabang dengan bijak – beri nama yang jelas (misalnya refactor-login, fix-bug-42) supaya kamu tahu apa yang dilakukan setiap agen.

---

Ringkasan

Git worktree memungkinkan kamu menjalankan beberapa agen Hermes di proyek yang sama tanpa mereka saling menginjak kaki. Buat worktree untuk setiap agen, arahkan Hermes ke sana, dan selesai. Ini seperti memberi setiap koki talenan sendiri—dapur yang sama, nol tabrakan.

Selanjutnya: Di Tutorial 16, kita akan deploy Hermes dengan Docker — asisten yang bisa menyembuhkan diri sendiri dan selalu aktif.