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 loginbird 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
- Configurer votre agent de codage : collez un prompt et votre agent installe CLI et les compétences.
- Compétences de l'agent : ce que chaque compétence enseigne à votre agent.
- Référence CLI : chaque commande, flag et forme de sortie.
- Serveur MCP : la même surface Bird que les outils MCP, pour les agents qui appellent des outils au lieu d'exécuter un shell.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Regarder le guideSetting up your coding agentComprendre le conceptWhat is an MCP server, and how does an agent use one to send messages?Explorer la fonctionnalitéCoding agentsSuivre le parcours d'apprentissageBuild with AI agents
Obtenir un guide d'implémentation