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 enregistre une autorisation liée à 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 renvoie l'outil MCP whoami. Un simple bird auth login demande un accès en lecture seule, et Agent controls liste ce qui encadre l'agent dès qu'il peut envoyer : clés à portée limitée, envois idempotents, liste de pays SMS refusés par défaut, plafonds de dépenses SMS quotidiens et portefeuille prépayé.

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 une nouvelle tentative sûre.

Étapes suivantes