Sign inGet Started

CLI pour les agents

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

Mise en route

Le chemin le plus rapide est de configurer votre agent de codage : collez un prompt et votre agent installe CLI et les compétences de 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 un jeton lié à votre espace de travail et à sa région, vous n'avez donc pas à configurer de clé API ni d'hôte. bird auth status se termine toujours avec 0 et affiche valid: true dès que le jeton fonctionne. bird whoami renvoie l'utilisateur connecté (ID, e-mail et nom), c'est-à-dire l'identité sous laquelle l'agent agit et que l'outil MCP whoami renvoie.

Le contrat

  • JSON sur stdout ; erreurs et diagnostics sur stderr ; jamais mélangés.
  • Codes de sortie : six codes sémantiques couvrant l'utilisation, not-found, auth, conflict, les erreurs transitoires et un code générique. Consultez le tableau complet dans CLI.
  • Les mutations prennent leurs entrées depuis les flags, un corps JSON via --body-file - (stdin), ou les deux, le flag ayant 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