Documentazione
Sign inGet started
Inizia ora
Guide
Riferimento API
SDK
CLI
Knowledge Base
Changelog

CLI per agenti

bird CLI è un singolo binario progettato per essere pilotato da un agente. L'output è JSON per impostazione predefinita, gli errori vanno su stderr e i codici di uscita indicano la categoria del problema.

Configurazione

Il percorso più rapido è configurare il tuo coding agent: incolla un prompt e il tuo agente installa CLI e le skill di Bird al posto tuo. Per installarlo manualmente:
Esempio di codice
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth login
bird auth login esegue un flusso OAuth nel browser e memorizza un grant legato al tuo spazio di lavoro e alla sua regione, quindi non devi configurare una chiave API né un host. bird auth status esce sempre con 0 e riporta valid: true quando il token funziona. bird whoami restituisce l'utente autenticato (ID, email e nome), ovvero l'identità con cui agisce l'agente e che il tool MCP whoami restituisce.

Il contratto

  • JSON su stdout; errori e diagnostica su stderr; mai mescolati.
  • Codici di uscita: sei codici semantici che coprono usage, not-found, auth, conflict, errori transitori e un fallback generico. La tabella completa è in CLI.
  • Le mutazioni ricevono input dai flag, da un body JSON tramite --body-file - (stdin), o da entrambi; in caso di conflitto prevale il flag.
  • --example stampa un corpo di richiesta valido, --dry-run mostra un'anteprima della richiesta senza inviarla e --idempotency-key rende sicuro riprovare.

Prossimi passi

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Guarda la guidaSetting up your coding agentComprendi il concettoWhat is an MCP server, and how does an agent use one to send messages?Esplora la funzionalitàCoding agentsSegui il percorso di apprendimentoBuild with AI agents
Ottieni un brief di implementazione