Bekerja dengan agen AI

Otomatisasi Zshell terutama ditujukan untuk agen pemrograman AI. Fitur ini memberi mereka cara aman untuk bekerja dengan panel Zshell dan mengoordinasikan agen lain; bukan bahasa perintah baru yang perlu Anda pelajari.

Integrasi AI aktif secara bawaan. Bicaralah seperti biasa kepada agen Anda. Agen dapat membuat panel latar belakang, memulai pekerja yang didelegasikan, menjalankan perintah, menunggu hasil, dan membawa jawaban kembali tanpa merebut fokus dari panel yang Anda gunakan.

Menunggu hasil perintahSalin tautan

Untuk perintah yang selesai, seperti pengujian atau build, agen Anda dapat menunggu kode keluar dan durasi perintah itu sendiri, lalu membaca keluaran terminal terbaru yang disimpan. Jika waktu tunggu habis, perintah tetap berjalan dan tugas yang sama dapat ditunggu lagi tanpa memindahkan fokus. Ini memerlukan prompt kosong di zsh lokal asli yang diluncurkan Zshell; shell bersarang, SSH, dan program awal khusus tidak didukung. Keluaran terbaru dibatasi dan dapat mencakup perintah atau prompt sebelumnya. Minta agen menyimpan keluaran lengkap ke berkas bila diperlukan.

Panggilan langsung exit, logout, dan exec ditolak karena mengakhiri atau menggantikan shell asli; gunakan /bin/sh -c untuk menjalankannya dalam subproses.

PengaturanSalin tautan

Periksa Pengaturan → Otomatisasi → AI. Fitur ini aktif secara bawaan. Jika pernah Anda matikan, aktifkan lagi, lalu buka terminal baru atau mulai ulang agen yang sudah berjalan.

Zshell mendukung Codex, Claude Code, Gemini CLI, Grok Build, OpenCode, Cursor Agent, Aider, Amp, dan Pi. Jika menemukan penyiapan agen yang bertentangan dengan fitur ini, Zshell membiarkannya tetap utuh, mengembalikan sakelar ke keadaan semula, dan menampilkan kesalahan di Pengaturan.

Minta dengan bahasa biasaSalin tautan

Sampaikan hasil yang Anda inginkan. Contohnya:

Jalankan pengujian yang relevan di panel latar belakang dan beri tahu apa yang gagal.

Delegasikan bug ini ke agen Codex lain, lalu tinjau hasilnya.

Tanyakan kepada agen API apakah skemanya sudah siap, lalu teruskan jawabannya ke agen pengujian.

Jalankan server pengembangan di sebelah kita, tunggu hingga siap, lalu berikan URL-nya.

Periksa apakah agen latar belakang sudah selesai. Jika terhambat, beri tahu apa yang dibutuhkannya.

Agen menangani antarmuka otomatisasi Zshell untuk Anda. Anda tidak perlu mengetik atau menghafal perintah otomatisasinya.

Koordinasi agen antarpanelSalin tautan

Anda dapat membagi pekerjaan terkait ke beberapa panel Zshell dan meminta agen utama mengoordinasikannya. Misalnya, satu agen mengerjakan API sementara agen lain memperbarui pengujian. Agen koordinator dapat meminta temuan pekerja tertentu, mengirim tindak lanjut, meneruskan hasil yang berguna ke pekerja lain, lalu membawa jawaban gabungan kepada Anda. Para pekerja dapat menggunakan alat pemrograman berbeda yang didukung.

Ini menghilangkan langkah salin-tempel dalam kerja paralel. Setiap agen menyimpan percakapan di panelnya sendiri, sedangkan koordinator hanya meneruskan pertanyaan, pembaruan, atau hasil yang dibutuhkan pekerja lain.

Mengirim tindak lanjut tidak berarti pekerjaan selesai. Koordinator tetap menunggu pekerja, membaca hasilnya, dan memeriksa keluaran. Pesan dari agen lain tidak pernah dianggap sebagai persetujuan Anda. Izin, kredensial, keputusan kepercayaan, dan tindakan destruktif tetap membutuhkan keputusan Anda.

Tetap bekerja selama agen berjalanSalin tautan

Panel delegasi tetap di latar belakang kecuali Anda meminta melihatnya. Ketika integrasi siklus hidup native penyedia melaporkan status, Zshell menampilkannya pada panel dan tab agen:

Zshell memprioritaskan peristiwa bawaan Codex, Claude Code, Pi, OpenCode, dan Grok, lalu laporan eksplisit program. Arahkan penunjuk ke lencana atau buka Agents untuk melihat sumber, alasan menunggu, persentase, dan subtugas. Hook Codex harus ditinjau dan dipercaya melalui /hooks; Zshell tidak melewatinya.

Tanpa laporan bawaan, hanya bagian terbatas dari bawah layar aktif proses agen yang dikenali yang diperiksa. Inferensi layar diberi label, tidak melaporkan penyelesaian, tidak mengirim notifikasi, dan tidak memenuhi zshell +agent wait. Inferensi tidak memberikan persetujuan. Periksa panel dan hasil sebenarnya.

Program melaporkan progres dengan zshell +agent report dan menghapus laporannya sendiri dengan zshell +agent clear. Laporan kedaluwarsa setelah 120 detik tanpa pembaruan atau saat proses pemilik berakhir.

Saat integrasi melaporkan penyelesaian atau kebutuhan input, Zshell juga dapat mengirim notifikasi. Tekan Cmd+Shift+A untuk menuju agen berikutnya yang dilaporkan memerlukan perhatian.

Penggunaan akun dan batasSalin tautan

Pengaturan → Otomatisasi → Penggunaan Akun (Account Usage) menampilkan batas akun yang tersedia untuk Claude Code dan Codex, termasuk persentase terpakai, waktu reset jika dilaporkan, dan waktu pembaruan terakhir. Gunakan Segarkan Penggunaan (Refresh Usage) untuk memuat data terbaru yang tersedia.

Codex memerlukan CLI terpasang dan sudah masuk yang dapat melaporkan batas akun. Penggunaan Claude Code muncul ketika Zshell menerima laporan penggunaan dari baris status penyedia. Bagian ini hanya tampil bila data tersedia; periode yang didukung bergantung pada penyedia dan akun. Ini batas akun, bukan total token sesi aktif.

Alur kerja umumSalin tautan

1. Mulai agen pemrograman biasa Anda di terminal Zshell.
2. Minta agen mendelegasikan tugas terbatas, menjalankan sesuatu di latar belakang, atau mengoordinasikan agen lain.
3. Lanjutkan pekerjaan di panel saat ini sementara tugas delegasi tetap terlihat dalam tata letak proyek.
4. Ikuti lencana Bekerja, Terhambat, atau Selesai dari penyedia bila tersedia. Jika alat tidak melaporkan siklus hidup, buka panel untuk memeriksa percakapan atau keluaran terminalnya.
5. Tinjau berkas hasil di panel Git, periksa diff, dan tentukan yang akan dipertahankan.

Anda tetap memegang kendaliSalin tautan

• Otomatisasi agen tetap dalam proyek Zshell saat ini dan tidak dapat menjangkau panel proyek atau jendela lain.
• Pekerjaan latar belakang tidak mengambil fokus kecuali Anda memintanya secara eksplisit.
• Zshell tidak menjawab permintaan izin, kredensial, kepercayaan, atau tindakan destruktif untuk Anda. Agen yang dilaporkan terhambat mengembalikan keputusan itu kepada Anda.
• Laporan selesai adalah tanda untuk meninjau hasil, bukan persetujuan otomatis atas perubahan agen.

Jika agen tidak menggunakan ZshellSalin tautan

• Pastikan Pengaturan → Otomatisasi → AI aktif.
• Buka terminal Zshell baru jika terminal saat ini sudah ada sebelum pengaturan diaktifkan.
• Mulai ulang agen yang telah berjalan saat fitur diaktifkan.
• Periksa kesalahan penyiapan yang ditampilkan di Pengaturan.
• Minta secara eksplisit “panel Zshell latar belakang” atau “agen Zshell yang didelegasikan” jika ingin alur ini digunakan untuk tugas tersebut.

Melanjutkan percakapan asliSalin tautan

Dengan Lanjutkan percakapan agen, panel yang PTY asalnya tidak tersedia melanjutkan percakapan Claude Code, Codex, Pi, atau OpenCode yang tercatat untuk panel tersebut. Panel dalam direktori yang sama tetap memiliki percakapan masing-masing.

Zshell memasang hook SessionStart untuk Claude Code dan Codex, ekstensi Pi, serta plugin TUI OpenCode pada konfigurasi penyedia yang sudah ada. Hook, plugin, pengaturan, dan komentar JSONC lain tetap tersimpan. Jika diminta penyedia, aktifkan hook dalam konfirmasi kepercayaan Claude Code dan setujui hook Codex baru melalui /hooks. Mulai ulang agen yang berjalan sebelum pemasangan.

Hanya percakapan induk terverifikasi yang dilaporkan integrasi ini dapat dilanjutkan. Sesi app-server Codex bersama didukung jika ID percakapan terverifikasi cocok dengan panel; kecocokan ambigu tidak ditautkan. Untuk percakapan pada host jarak jauh, lihat sesi jarak jauh bersama. OpenCode memerlukan API plugin TUI; versi lama, sesi server tanpa antarmuka, dan opencode attach tidak didukung. Agen anak tidak dapat mengganti percakapan panel induk. Pi memerlukan berkas sesi tersimpan.

Tanpa identitas terverifikasi, direktori kerja asli, atau berkas Pi, shell baru terbuka. CLI yang tidak ditemukan juga kembali ke shell. Zshell tidak menjalankan ulang perintah awal sembarang atau memilih percakapan terbaru. Kesalahan penyedia, seperti percakapan yang dihapus, ditampilkan oleh CLI.

Menemukan dan melanjutkan percakapan tersimpanSalin tautan

Buka Agen → Riwayat Percakapan Agen, klik jam di bagian atas bilah samping proyek. Cari lintas proyek menurut judul, penyedia, proyek, ID percakapan, direktori kerja atau konfigurasi. Zshell menyimpan 200 percakapan lokal terverifikasi terbaru setelah agen dan panel ditutup serta aplikasi dimulai ulang. Terbaru menampilkan 20 hasil yang belum diarsipkan; Semua mencakup arsip; Diarsipkan hanya menampilkan arsip.

Pilih Tampilkan percakapan jika masih terbuka atau Lanjutkan percakapan jika tersimpan. Zshell memakai panel terbuka, menyambungkan kembali PTY yang masih aktif, atau melanjutkan percakapan penyedia yang tepat dengan direktori dan konfigurasi asli. Pelanjutan manual memerlukan integrasi AI meski pemulihan otomatis dimatikan. Direktori yang hilang serta berkas Pi yang hilang atau tidak cocok menampilkan kesalahan sebelum panel dibuat.

Arsipkan menyembunyikan catatan dari Terbaru; Batalkan arsip mengembalikannya. Hapus… hanya menghapus catatan Zshell dan mempertahankan berkas percakapan penyedia.

Di panel Zshell, zshell +agent history --all dan zshell +agent resume --id HISTORY_UUID berlaku untuk proyek panel itu. Dari terminal eksternal biasa, biarkan Zshell berjalan, temukan UUID proyek, lalu pilih secara eksplisit:

zshell +agent history projects
zshell +agent history --project PROJECT_UUID --all
zshell +agent resume --project PROJECT_UUID --id HISTORY_UUID --focus

CLI melanjutkan di latar belakang kecuali ditambah --focus. Untuk proyek di beberapa jendela, pilih --window WINDOW_UUID dari history projects. Jika beberapa instans aplikasi berjalan, gunakan --connection PATH dengan jalur absolut berkas koneksi pribadi yang ditunjukkan CLI. Target ini hanya untuk terminal eksternal; proses panel tetap dalam cakupan proyek asal.

Mengikuti peristiwa proyek langsungSalin tautan

Jalankan zshell +events di terminal Zshell untuk mengikuti perubahan berikutnya pada proyek dan jendelanya sebagai NDJSON tanpa polling. Opsi: --pane UUID, --event NAME yang dapat diulang, --once, dan --timeout MS (0 menunggu tanpa batas).

Mencakup pembuatan dan penutupan sesi serta panel, fokus, kemajuan, perhatian dan penyelesaian agen, serta perintah selesai. stream.ready dimulai pada sequence 0; setiap peristiwa yang cocok menambah urutan. Setiap baris memuat version, event, stream_id, sequence, time dalam milidetik Unix, project_id, dan data. Riwayat tidak diputar ulang. Baca hasil dengan +pane wait --task UUID.

Batas: 32 langganan, 256 bingkai dan 1 MiB per antrean, 64 KiB per bingkai. Pembaca lambat menerima stream.lagged jika memungkinkan lalu terputus; gagal menulis selama 2 detik juga menutup koneksi. Keterlambatan, putus tak terduga, atau kesalahan urutan menghasilkan kode bukan nol. Langganan ulang dan baca keadaan saat ini. Menutup terminal, mengganti token, atau memindahkan ke proyek/jendela lain mengakhiri langganan. Tidak ada kontrol eksternal atau --project; menghapus variabel tidak memperluas izin. --once tanpa kecocokan mengembalikan 124 saat waktu habis; batas waktu biasa mengembalikan 0.

zshell +events --event command.task.finished --once --timeout 30000

pane.updated: data.from → data (tab_id, pane_id, terminal_id, content).