CLI für Agenten
Die bird CLI ist eine einzelne Binärdatei, die für die Steuerung durch einen Agenten gebaut wurde. Die Ausgabe ist standardmäßig JSON, Fehler gehen nach stderr, und Exit-Codes tragen die Fehlerkategorie.
Einrichtung
Der schnellste Weg ist, Ihren Coding-Agenten einzurichten: Fügen Sie einen Prompt ein, und Ihr Agent installiert die CLI und die Skills von Bird für Sie. So installieren Sie es manuell:
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth loginbird auth login startet einen OAuth-Flow im Browser und speichert eine Berechtigung, die an Ihren Workspace und dessen Region gebunden ist, sodass Sie keinen API-Schlüssel und keinen Host konfigurieren müssen. bird auth status beendet sich immer mit 0 und meldet valid: true, sobald das Token funktioniert. bird whoami gibt den angemeldeten Benutzer zurück (ID, E-Mail und Name). Das ist die Identität, unter der der Agent handelt und die das MCP whoami-Tool zurückgibt. Ein einfaches bird auth login fordert nur Lesezugriff an, und Agent controls listet auf, was den Agenten begrenzt, sobald er senden kann: Schlüssel mit eingeschränktem Geltungsbereich, idempotente Sendungen, die standardmäßig sperrende SMS-Länderliste, tägliche SMS-Ausgabenlimits und das Prepaid-Guthaben.
Der Vertrag
- JSON nach stdout; Fehler und Diagnosen nach stderr; nie vermischt.
- Exit-Codes: sechs semantische Codes für Usage, Not-Found, Auth, Conflict, transiente Fehler und einen allgemeinen Fallback. Die vollständige Tabelle finden Sie unter CLI.
- Mutationen nehmen Eingaben aus Flags, einem JSON-Body über
--body-file -(stdin) oder beidem entgegen, wobei das Flag Vorrang hat. --examplegibt einen gültigen Request-Body aus,--dry-runzeigt den Request als Vorschau an, ohne ihn zu senden, und mit--idempotency-keykönnen Sie einen Request gefahrlos erneut versuchen.
Nächste Schritte
- Ihren Coding-Agenten einrichten: Fügen Sie einen Prompt ein, und Ihr Agent installiert die CLI und die Skills.
- Agenten-Skills: Was jeder Skill Ihren Agenten lehrt.
- CLI-Referenz: Alle Befehle, Flags und Ausgabeformate.
- MCP-Server: Dieselbe Bird-Oberfläche wie MCP-Tools, für Agenten, die Tools aufrufen statt eine Shell auszuführen.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.