CLI untuk agen

CLI bird adalah binary tunggal 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: tempelkan satu prompt dan agen Anda akan menginstal CLI serta skill Bird untuk Anda. Untuk menginstal secara manual:

Contoh kode

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 ke workspace dan region Anda, sehingga Anda tidak perlu mengonfigurasi API key atau host. bird auth status selalu mengembalikan exit 0 dan melaporkan valid: true setelah token berfungsi. bird whoami mengembalikan pengguna yang sedang login (ID, email, dan nama), yang merupakan identitas yang digunakan agen dan dikembalikan oleh tool MCP whoami.

Kontrak

JSON ke stdout; error dan diagnostik ke stderr; tidak pernah dicampur.
Exit code: enam kode semantik yang 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 mengirimkannya, dan --idempotency-key membuat retry menjadi aman.

Langkah selanjutnya

Siapkan coding agent Anda: tempelkan prompt dan agen Anda akan menginstal CLI serta skill.
Skill agen: apa yang diajarkan setiap skill kepada agen Anda.
Referensi CLI: setiap perintah, flag, dan bentuk output.
Server MCP: surface Bird yang sama sebagai tool MCP, untuk agen yang memanggil tool alih-alih menjalankan shell.