Menjalankan satu agen Codex itu mudah. Anda buka terminal, tuliskan tugas, lalu lihat ia bekerja. Masalahnya baru muncul saat jumlahnya tiga. Satu agen sedang merombak modul auth, agen lain memperbaiki test yang flaky, agen ketiga menyusun draf migrasi, dan masing-masing berada di tab terminalnya sendiri dengan riwayat scroll-nya sendiri. Sepuluh menit kemudian Anda sudah tidak ingat tab mana untuk tugas yang mana, apakah migrasinya sudah selesai, atau di branch mana perbaikan test tadi mendarat. Agen-agennya baik-baik saja. Yang rusak adalah kemampuan Anda melacaknya.
Inilah masalah sebenarnya di balik "mengelola banyak agen Codex". Persoalannya bukan konkurensi; Codex dengan senang hati berjalan paralel di direktori kerja yang terpisah. Masalahnya adalah status pekerjaan itu—apa yang sedang dilakukan tiap agen, apa yang sudah selesai, apa yang gagal, dan apa yang perlu Anda tinjau—akhirnya tersebar di tab terminal, folder worktree, dan ingatan Anda sendiri. Kehilangan satu saja dari itu, Anda kehilangan jejaknya.
Sharkly hadir justru untuk celah ini. Anda sudah punya agen coding; Sharkly mengubahnya menjadi sebuah tim dengan memberi setiap sesi agen satu catatan bersama. Artikel ini membahas dulu cara setup manualnya, karena Anda perlu memahami apa yang sebenarnya Anda otomatiskan, lalu menunjukkan di titik mana sebuah task board layak dipakai. Di akhir, ada checklist yang bisa Anda jalankan hari ini.
Apa arti "kehilangan jejak" sebenarnya
Kehilangan jejak bukan hal yang samar. Ia adalah kegagalan yang spesifik: status pekerjaan Anda tidak punya satu tempat tinggal. Ketika Anda menjalankan beberapa sesi Codex secara manual, kebenaran tentang tiap tugas terpecah di empat tempat sekaligus. Instruksinya ada di terminal tempat Anda mengetiknya, perubahannya ada di direktori kerja Git, statusnya ada di kepala Anda, dan hasilnya ada di pull request yang belum Anda buka. Tidak ada yang menjaga keempatnya tetap sinkron. Tutup terminalnya, instruksinya hilang. Pindah tab, statusnya cuma tebakan. Semakin banyak agen yang Anda tambahkan, semakin banyak salinan "apa yang sedang terjadi" yang Anda pelihara, dan Anda adalah satu-satunya titik integrasi yang menyatukan semuanya.
Jadi tujuan mengelola banyak agen Codex itu sempit dan layak dinyatakan secara gamblang: simpan tugas, progres, perubahan, dan status review setiap agen di satu tempat, bukan terpecah di sesi terminal yang bersifat pribadi. Semua yang dibahas di bawah akan diukur dengan satu tolok ukur itu.
Langkah 1: Isolasi tiap agen dengan worktree
Mode kegagalan pertama adalah tabrakan. Arahkan dua agen Codex ke folder yang sama dan mereka akan saling menimpa perubahan satu sama lain, saling men-stage file, dan menghasilkan diff yang tidak bisa dibaca siapa pun. Git worktree menyelesaikan ini dengan rapi: setiap agen mendapat checkout-nya sendiri dari repositori yang sama, di branch-nya sendiri.
# One isolated working directory per task, each on its own branch
git worktree add ../repo-auth -b agent/auth-refactor
git worktree add ../repo-flaky -b agent/flaky-test
git worktree add ../repo-migration -b agent/db-migration
Sekarang jalankan satu sesi Codex di dalam tiap direktori. Setiap agen hanya melihat file miliknya sendiri, melakukan commit ke branch-nya sendiri, dan tidak bisa mengganggu yang lain.
cd ../repo-auth && codex # agent 1, auth refactor
cd ../repo-flaky && codex # agent 2, flaky test
Mode kegagalan yang perlu disebut di sini: worktree menyelesaikan tabrakan file, bukan pelacakan. Sekarang Anda punya tiga folder dengan nama yang hampir sama dan tidak ada catatan tugas apa yang ada di masing-masingnya. Pakai konvensi penamaan yang menyandikan tugasnya (agent/<task>), karena seminggu kemudian repo-2 dan repo-3 tidak akan berarti apa-apa. Jika ingin tahu mekanisme yang lebih dalam, lihat Git worktree untuk agen coding AI dan pola yang lebih luas di menjalankan beberapa tugas Codex sekaligus.
Langkah 2: Jaga sesi tetap terlihat
Tiga agen di tiga tab berarti Anda hanya berjarak satu Cmd+W yang tidak sengaja dari mematikan tugas yang sedang berjalan dan kehilangan riwayat scroll-nya. Terminal multiplexer seperti tmux menjaga setiap sesi tetap hidup di dalam window bernama yang bisa Anda lepaskan (detach) dan sambungkan kembali (reattach) nanti.
tmux new-session -d -s codex -n auth 'cd ../repo-auth && codex'
tmux new-window -t codex -n flaky 'cd ../repo-flaky && codex'
tmux new-window -t codex -n migration 'cd ../repo-migration && codex'
tmux attach -t codex
Window bernama (auth, flaky, migration) mengembalikan label yang dibuang oleh tab biasa. Detach dengan Ctrl-b d, tutup laptop Anda, reattach keesokan paginya, dan sesinya masih ada di sana.
Mode kegagalan yang perlu disebut di sini: tmux menjaga sesi tetap berjalan; ia tidak memberi tahu Anda sesi mana yang membutuhkan Anda. Agen yang selesai dua puluh menit lalu dan agen yang kena error terlihat sama dari luar: pane yang sunyi. Anda tetap harus mengunjungi tiap window dan membaca seratus baris terakhir untuk mengetahui statusnya. Biaya polling ini bertambah seiring setiap agen yang Anda tambahkan, dan itulah pajak yang membuat setup manual terasa makin berat seiring waktu.
Langkah 3: Catat status dan review di tempat yang tahan lama
Bagian manual terakhir adalah yang paling sering dilewatkan orang: menuliskan apa yang dihasilkan tiap agen dan apakah Anda menerimanya. Riwayat scroll bukanlah catatan. Ia hilang, tidak bisa dicari lintas tugas, dan rekan satu tim tidak bisa membacanya. Versi sederhananya adalah checklist biasa yang Anda perbarui sendiri.
TASK BRANCH STATUS REVIEW
auth refactor agent/auth-refactor done needs review
flaky test agent/flaky-test running -
db migration agent/db-migration failed: perm not reviewed
Intinya seluruh pekerjaan, dalam bentuk mini: tempat yang tahan lama di mana progres, hambatan, hasil, dan review manusia tetap terlihat dari permintaan sampai rilis. Jaga ini dengan disiplin dan Anda bisa mengelola beberapa agen dari terminal untuk waktu yang lama. Jebakannya adalah Anda yang menjadi mesin sinkronisasinya, memperbaruinya manual setiap kali ada perubahan. Untuk lebih jauh soal membuat output agen bisa diaudit, lihat cara melacak pekerjaan yang diselesaikan agen coding AI.
Di mana setup DIY berhenti berskala
Bersikaplah jujur tentang kapan pendekatan manual sudah cukup. Untuk satu atau dua agen Codex dengan tugas yang ruang lingkupnya jelas, worktree plus konvensi penamaan plus file status yang dirawat manual memang sudah cukup. Jangan tambahkan tooling yang tidak Anda butuhkan; komponen yang bergerak hampir nol dan semuanya muat di kepala Anda.
Persamaannya berubah di titik yang bisa diprediksi. Anda merasakannya ketika:
- Anda menjalankan tiga agen atau lebih dan biaya polling (kunjungi setiap pane, baca ekornya, ingat statusnya) menghabiskan lebih banyak waktu daripada yang dihemat agen-agen itu.
- Pekerjaannya mencakup lebih dari satu repositori, sehingga worktree saja tidak lagi cukup untuk memberi satu gambaran yang bersih.
- Orang lain bertanya "sedang apa agen-agennya sekarang?" dan satu-satunya jawaban jujur ada di terminal dan ingatan Anda.
Semua itu berakar pada penyebab yang sama seperti di awal artikel: status pekerjaan yang tidak punya tempat tinggal bersama. Setup manual menyimpannya di satu tempat yang tidak bisa berskala, yaitu Anda. Tim paling cepat menabrak dinding ini, itulah sebabnya tool terbaik untuk mengelola agen coding AI paralel semuanya mengarah ke langkah yang sama: beri pekerjaan itu tempat tinggal di luar terminal.
Apa yang ditambahkan task board
Task board mengubah unit pengelolaan dari "sesi terminal" menjadi "Task". Di Sharkly, Anda menghubungkan Computer yang sudah Anda pakai untuk menjalankan Codex, lalu menugaskan sebuah Task ke Agen Codex alih-alih mengetik di pane. Agen berjalan di worktree terisolasinya sendiri, dan eksekusi, progres, hambatan, serta hasilnya kembali ke Task tersebut. Anda berhenti melakukan polling; board-nya sudah tahu apa yang selesai dan apa yang gagal.
Pembagian kerjanya memang disengaja, dan layak dinyatakan sebagai batas: Sharkly bukan pengganti Codex. Codex yang melakukan eksekusi. Sharkly menambahkan lapisan task, Computer, konteks, dan review bersama di sekelilingnya. Agen meneliti, mengeksekusi, menguji, dan melaporkan; manusia menentukan arah, memberi wewenang, dan menerima hasilnya. Otomasi berhenti di titik yang membutuhkan penilaian Anda, yaitu gerbang review, bukan kodenya.
Itulah yang sebenarnya ingin dicapai oleh file status manual tadi, kini dibuat tahan lama dan bisa dibagi. Ada tiga hal yang tidak bisa diberikan terminal:
- Status tanpa polling. Setiap Task menampilkan running, done, blocked, atau needs-review tanpa Anda harus mengunjungi pane.
- Satu gambaran lintas repositori. Task dari banyak repo dan banyak Agen berada dalam satu Space, jadi makin banyak agen tidak berarti makin banyak terminal yang harus Anda jaga. Ini alasan yang sama mengapa tim menjalankan Claude Code dan Codex bersamaan dari satu tempat.
- Langkah review yang benar-benar dijalankan. Hasil menunggu di gerbang human-in-the-loop dengan ringkasan perubahan dan bukti terlampir, sehingga tidak ada yang ter-merge hanya karena Anda lupa bahwa ada yang masih tertunda.
Anda bisa membangun semua ini sendiri dengan worktree dan disiplin, atau memakai Sharkly untuk mengelola alur kerjanya saat jumlah agen menanjak. Codex tetap seperti semula; beban manajemennya berpindah dari pundak Anda. Jika Anda sudah menjalankan beberapa agen Codex, itulah masalah yang dirancang untuk dijawab Sharkly.
Checklist yang bisa Anda jalankan hari ini
Baik Anda tetap manual atau beralih ke board, ini batas minimum agar Anda tidak kehilangan jejak:
- [ ] Satu worktree terisolasi per agen, di branch yang dinamai sesuai tugasnya, jangan pernah dua agen di satu folder.
- [ ] Konvensi penamaan yang menyandikan tugasnya, sehingga
agent/auth-refactorlebih baik daripadarepo-3. - [ ] Sesi berumur panjang (tmux atau board) yang bisa Anda detach dan reattach tanpa mematikan pekerjaan.
- [ ] Catatan status yang tahan lama di luar riwayat scroll terminal: task, branch, status, status review.
- [ ] Gerbang review yang eksplisit; tidak ada branch yang di-merge sebelum manusia menerimanya.
- [ ] Cek jumlah: saat tiga agen atau lebih, atau dua repo atau lebih, pindahkan statusnya keluar dari kepala Anda.
Jalankan versi manual sampai pajak polling-nya terasa menyakitkan. Kalau sudah, jalankan agen coding Anda yang ada lewat Sharkly agar pelacakannya menjadi tugas board, bukan tugas Anda.
FAQ
Berapa banyak agen Codex yang realistis saya jalankan sekaligus? Sebanyak yang diizinkan mesin dan rate limit Anda; batas yang Anda tabrak lebih dulu biasanya manusia, bukan teknis. Melacak tiga agen atau lebih secara manual adalah titik di mana kebanyakan orang kehilangan jejak. Lihat thread dan subagen konkuren Codex untuk batasan di sisi eksekusi.
Apakah task board menggantikan Codex? Tidak. Codex yang mengeksekusi; board mengelola penugasan, isolasi, konteks, dan review di sekelilingnya. Keduanya saling melengkapi.
