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:

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

• Configura il tuo coding agent: incolla un prompt e il tuo agente installa CLI e le skill.
• Skill per agenti: cosa insegna ogni skill al tuo agente.
• Riferimento CLI: ogni comando, flag e formato di output.
• Server MCP: la stessa superficie Bird dei tool MCP, per agenti che chiamano tool invece di eseguire una shell.