Harness agen
Perch menjalankan harness agen lengkap di Desktop dan CLI: shell, pencarian, pengeditan file, tugas latar belakang, sandbox tertutup, mode Plan, dan izin bertingkat berdasarkan risiko. Berikut seluruh perangkat tool-nya beserta kontrol yang mengaturnya.
Di balik pekerjaan dokumen dan audit, Perch adalah harness agen serbaguna. Perch menjalankan perintah, mencari dan mengedit file, memunculkan agen pembantu, dan mengeksekusi kode di sandbox. Mesin yang merekonsiliasi buku besar juga akan me-refactor sebuah modul, karena memang mesinnya sama.
Halaman ini adalah referensi tentang apa yang sebenarnya bisa dilakukan Perch di komputer Anda, serta kontrol yang menentukan seberapa banyak hal itu terjadi tanpa bertanya kepada Anda terlebih dahulu.
Hanya Desktop dan CLI
Shell dan pencarian
| Tool | Fungsinya |
|---|---|
bash | Menjalankan perintah shell di ruang kerja. |
grep | Mencari isi file di seluruh folder. |
glob | Menemukan file berdasarkan pola. |
Pencarian berjalan sebagai grep dan glob sungguhan, bukan tebakan semantik, sehingga menemukan setiap pemanggilan berarti benar-benar menemukan setiap pemanggilan.
Membaca dan menulis file
| Tool | Fungsinya |
|---|---|
readLocalFile | Membaca file ke dalam konteks. |
writeLocalFile | Menulis file. |
editLocalFile | Mengedit sebagian file secara langsung. |
moveLocalFile, copyLocalFile | Memindahkan atau menyalin. |
createDirectory, deleteLocalFile | Membuat direktori, menghapus file. |
statPath | Memeriksa sebuah path tanpa membacanya. |
Setiap pemanggilan divalidasi terhadap root yang disetujui untuk ruang kerja Anda, sehingga Perch tidak bisa menjangkau di luar folder yang Anda buka.
Tugas latar belakang
Pekerjaan panjang tidak harus menghambat percakapan. Perch dapat memulai perintah di latar belakang dan terus bekerja.
| Tool | Fungsinya |
|---|---|
run_in_background | Memulai perintah sebagai tugas terpisah. |
check_background_task | Memeriksa statusnya. |
list_background_tasks | Menampilkan daftar yang sedang berjalan. |
wait_for_background_task | Menunggu sampai selesai. |
kill_background_task | Menghentikannya. |
Inilah yang membuat rangkaian tes, build, atau instalasi panjang menjadi sesuatu yang bisa diawasi Perch, bukan sesuatu yang harus ditunggui.
Sandbox
Untuk pekerjaan yang memerlukan komputasi nyata, bukan sekadar penalaran tentang angka, Perch menulis kode dan menjalankannya di sandbox tertutup dengan run_sandbox_code. Dengan cara inilah sebuah total dihitung, bukan ditebak.
Sandbox ini sengaja diperketat:
- Jaringan dinonaktifkan. Sandbox tidak memiliki akses keluar.
- Seatbelt macOS. Eksekusi berjalan di bawah profil
sandbox-exec, terisolasi dari bagian lain komputer Anda. - Asal-usul tercatat. Eksekusi sandbox dicatat, sehingga angka hasil perhitungan bisa ditelusuri kembali ke kode yang menghasilkannya.
Perencanaan dan pelacakan tugas
Perch memiliki perencanaan sebagai fitur utama, bukan sekadar instruksi untuk "berpikir langkah demi langkah":
- Mode Plan memungkinkan Perch memeriksa ruang kerja dan menyusun draf rencana, dengan tool yang mengubah apa pun diblokir sampai Anda menyetujuinya. Anda mendapat kartu rencana, dan tidak ada yang ditulis selama Anda membacanya.
- Todo memungkinkan Perch menjaga daftar tugas yang terlihat sepanjang proses panjang, sehingga Anda bisa memantau kemajuan alih-alih menebaknya.
- Pertanyaan. Saat Perch benar-benar terhambat oleh keputusan yang menjadi wewenang Anda, Perch bertanya alih-alih memilihkan untuk Anda.
Mode chat
Composer memiliki tiga mode, dan mode ini mengubah apa yang boleh dilakukan dalam satu giliran:
| Mode | Perilaku |
|---|---|
| Ask | Percakapan. Tanyakan tentang folder, unggahan, atau langkah berikutnya. |
| Plan | Perch memeriksa, menyusun draf rencana, dan menunggu persetujuan sebelum bertindak. |
| Agents | Perch merencanakan dan menjalankan tugasnya. |
Mode izin
Terpisah dari mode chat, pengaturan izin menentukan seberapa banyak yang berjalan tanpa persetujuan. Pengaturan ini bertingkat berdasarkan risiko, bukan satu sakelar nyala dan mati:
| Mode | Yang berjalan tanpa bertanya |
|---|---|
| Default | Tidak ada yang berisiko. Penulisan, perintah, pengiriman, penghapusan, dan tindakan lain yang tidak dapat dibatalkan semuanya memerlukan persetujuan. |
| Auto Review | Pekerjaan berisiko rendah dan menengah yang dapat dibatalkan berjalan sendiri. Setiap tindakan berdampak di luar itu diperiksa oleh peninjau terpisah, yang hanya bertanya kepada Anda saat ragu. |
| Take the Wheel | Otonomi penuh. Perch dapat menulis, menghapus, mengirim, dan melakukan tindakan nyata yang tidak dapat dibatalkan tanpa bertanya. |
| Plan | Hanya baca. Tool yang mengubah apa pun tetap diblokir sampai rencana disetujui. |
Auto Review berjalan tanpa campur tangan Anda, tetapi tidak berjalan buta: pengeditan yang dapat dibatalkan dan perintah milik proyek itu sendiri tetap berjalan, tindakan berdampak ditinjau sebelum dijalankan, dan tindakan dengan risiko tertinggi (force push, penghapusan massal) selalu berhenti menunggu Anda. Garis yang ditariknya adalah antara yang dapat dibatalkan dan yang tidak, bukan antara yang mudah dan yang sulit, sehingga mengedit file yang bisa Anda kembalikan diperlakukan berbeda dari mengirim email. Lihat mode izin untuk cara peninjau mengambil keputusan.
Effort
Kontrol effort menentukan seberapa keras model bekerja dalam satu giliran. Bentuknya satu bilah dengan lima segmen: empat tingkat effort, lalu satu takik terpisah untuk Flock.
| Pengaturan | Artinya |
|---|---|
| Off | Tanpa berpikir. Paling cepat, dan paling hemat penggunaan Anda. |
| Low | Penalaran dangkal. Tugas pendek dengan cakupan jelas yang mengutamakan kecepatan. |
| Medium | Seimbang. Pemanggilan tool lebih sedikit dan lebih terkonsolidasi. |
| High | Default. Penalaran kompleks dan pekerjaan agentik. |
| Flock | Bukan tingkat effort. Merencanakan tim worker dan menjalankannya secara paralel. Paling cocok untuk pekerjaan besar yang bisa dipecah. |
Bagian menariknya ada di baliknya. Penyedia mengekspresikan penalaran dengan cara yang sama sekali berbeda: sebagian model mengabaikan parameter penalaran sepenuhnya, sebagian hanya menerima satu sakelar nyala dan mati, dan yang lain menyediakan tingkatan bernama milik mereka sendiri. Setiap model di daftar model menyatakan termasuk jenis yang mana, dan effort yang Anda pilih disesuaikan dengan model yang benar-benar terpilih untuk giliran itu.
Artinya, satu kontrol berperilaku konsisten, apa pun model yang dipilih Roost untuk Anda atau yang Anda sematkan sendiri. Bilah ini tidak pernah menjanjikan sesuatu yang tidak bisa dilakukan model.
Claude Opus 5.5 di Pro adalah model dengan tingkatannya sendiri: effort-nya mencakup low, medium, high, xhigh, dan max, dan mode berpikir selalu aktif, sehingga tidak ada Off.
Gemini 4 Argon di Pro menerima Low, Medium, dan High. Model ini selalu berpikir, sehingga Off berjalan sebagai Low.
Subagen
Perch dapat memunculkan agen pembantu selama satu giliran, dan Anda memilih model yang menjalankannya. Default-nya adalah Inherit, yang mengikuti model yang mengerjakan tugas utama. Menentukan model lain adalah cara agar satu model memeriksa pekerjaan model lain, bukan menilai pekerjaannya sendiri.
Pengaturan ini juga mencakup delegasi latar belakang. Model yang ditentukan secara spesifik lebih mahal daripada membiarkan routing berjalan otomatis.
Lihat Subagen untuk gambaran lengkapnya, dan Operator dan agen untuk perbedaan keempat mode multi-agen.
Skill
Perch membawa satu paket skill operator yang hanya dimuat saat relevan: navigasi ruang kerja, GitHub dan git, dokumen, spreadsheet, presentasi, PDF, diagram, riset, kualitas data, dan pengoperasian browser. Masing-masing berisi serangkaian instruksi plus tool pilihan untuk satu jenis pekerjaan. Metadatanya tetap ringan untuk dipindai, sementara instruksi lengkapnya hanya dimuat saat cocok.
Setiap skill juga membawa standar verifikasi, yaitu hal-hal yang harus dipastikannya sebelum memberikan hasil kepada Anda. Lihat Skill untuk paket lengkapnya dan cara sebuah skill dipilih.
Aturan proyek
Perch membaca instruksi tetap dari folder Anda di setiap giliran, dari .perch/PERCH.md dan .perch/rules/, ditambah panduan global di ~/Documents/Perch/PERCH.md. Aturan yang Anda taruh di sana mengesampingkan default Perch.
Lihat Memori untuk cara file proyek, memori persisten, dan pembelajaran dari koreksi saling melengkapi.
Cara kerja Perch
Perch membaca materi Anda terlebih dahulu, mendasarkan jawabannya pada apa yang ditemukan, dan menunjukkan sumber di balik setiap klaim.
Skill
Perch membawa satu paket skill operator yang hanya dimuat saat relevan. Masing-masing berisi aturan kerja, tool pilihan, dan standar verifikasi untuk satu jenis pekerjaan. Berikut skill yang tersedia dan cara sebuah skill dipilih.