CLI untuk agen

bird CLI adalah satu binary yang dibuat untuk dijalankan oleh agen. Output berupa JSON secara default, error dikirim ke stderr, dan exit code membawa kategori kegagalan.

Persiapan

Cara tercepat adalah menyiapkan coding agent Anda: tempel satu prompt dan agen Anda menginstal CLI beserta skill Bird untuk Anda. Untuk menginstal secara manual:

curl -fsSL https://cli.bird.com/install.sh | sh
bird auth login

bird auth login menjalankan alur OAuth di browser dan menyimpan grant yang terikat pada workspace dan region-nya, sehingga Anda tidak perlu mengonfigurasi API key atau host. bird auth status selalu keluar dengan 0 dan melaporkan valid: true setelah token berfungsi. bird whoami mengembalikan pengguna yang sudah masuk (ID, email, dan nama), yaitu identitas yang digunakan agen dan yang dikembalikan oleh tool MCP whoami.

Kontrak

• JSON ke stdout; error dan diagnostik ke stderr; tidak pernah tercampur.
• Exit code: enam kode semantik mencakup usage, not-found, auth, conflict, kegagalan sementara, dan fallback umum. Lihat tabel lengkapnya di CLI.
• Mutasi menerima input dari flag, body JSON melalui --body-file - (stdin), atau keduanya, dengan flag yang diutamakan.
• --example mencetak body request yang valid, --dry-run menampilkan pratinjau request tanpa mengirimnya, dan --idempotency-key membuat coba lagi menjadi aman.

Langkah selanjutnya

• Siapkan coding agent Anda: tempel satu prompt dan agen Anda menginstal CLI beserta skill.
• Skill agen: apa yang diajarkan setiap skill kepada agen Anda.
• Referensi CLI: setiap command, flag, dan bentuk output.
• Server MCP: surface Bird yang sama dengan tool MCP, untuk agen yang memanggil tool alih-alih menjalankan shell.