CLI pour les agents

Le CLI bird est un binaire unique conçu pour être piloté par un agent. La sortie est en JSON par défaut, les erreurs sont dirigées vers stderr et les codes de sortie indiquent la catégorie de l'échec.

Mise en route

Le moyen le plus rapide est de configurer votre agent de codage : collez une invite et votre agent installe le CLI et les compétences Bird pour vous. Pour l'installer manuellement :

Exemple de code

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

bird auth login lance un flux OAuth dans le navigateur et stocke une autorisation liée à votre espace de travail et sa région, vous n'avez donc pas besoin de configurer une clé API ou un hôte. bird auth status retourne toujours le code 0 et indique valid: true une fois que le jeton fonctionne. bird whoami renvoie l'utilisateur connecté (ID, e-mail et nom), qui est l'identité sous laquelle l'agent agit et que l'outil MCP whoami retourne.

Le contrat

JSON sur stdout ; erreurs et diagnostics sur stderr ; jamais mélangés.
Codes de sortie : six codes sémantiques couvrant l'utilisation, non-trouvé, authentification, conflit, échecs transitoires et un code générique de repli. Consultez le tableau complet dans CLI.
Les mutations prennent leurs entrées depuis des flags, un corps JSON via --body-file - (stdin), ou les deux, le flag ayant la priorité.
--example affiche un corps de requête valide, --dry-run prévisualise la requête sans l'envoyer, et --idempotency-key rend un réessai sûr.

Étapes suivantes

Configurer votre agent de codage : collez une invite et votre agent installe le CLI et les compétences.
Compétences des agents : ce que chaque compétence enseigne à votre agent.
Référence du CLI : chaque commande, flag et format de sortie.
Serveur MCP : la même surface Bird sous forme d'outils MCP, pour les agents qui appellent des outils au lieu d'exécuter un shell.