CLI per agenti
La CLI bird è un singolo binario progettato per essere utilizzato da un agente. L'output è JSON per impostazione predefinita, gli errori vanno su stderr e i codici di uscita indicano la categoria di errore.
Configurazione
Il percorso più rapido è configurare il proprio agente di codifica: incolla un prompt e il tuo agente installa la CLI e le skill di Bird per te. Per installarla manualmente:
Esempio di codice
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth loginbird auth login avvia un flusso OAuth nel browser e memorizza un'autorizzazione associata al tuo workspace e alla relativa regione, quindi non è necessario configurare una API key o un host. bird auth status restituisce sempre il codice di uscita 0 e riporta valid: true una volta che il token funziona. bird whoami restituisce l'utente autenticato (ID, email e nome), ovvero l'identità con cui l'agente opera 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 utilizzo, non trovato, autenticazione, conflitto, errori transitori e un fallback generico. Consulta la tabella completa in CLI.
- Le mutazioni accettano input da flag, un corpo JSON tramite --body-file - (stdin), o entrambi, con il flag che ha la priorità.
- --example stampa un corpo di richiesta valido, --dry-run mostra un'anteprima della richiesta senza inviarla e --idempotency-key rende sicuro un retry.
Passaggi successivi
- Configura il tuo agente di codifica: incolla un prompt e il tuo agente installa la CLI e le skill.
- Skill dell'agente: cosa insegna ogni skill al tuo agente.
- Riferimento CLI: ogni comando, flag e formato di output.
- Server MCP: la stessa superficie Bird come tool MCP, per agenti che chiamano tool invece di eseguire una shell.