CLI für Agenten

Die bird-CLI ist eine einzelne Binärdatei, die für die Steuerung durch einen Agenten entwickelt wurde. Die Ausgabe erfolgt standardmäßig als JSON, Fehler werden auf stderr ausgegeben, 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. Für eine manuelle Installation:

Codebeispiel

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

bird auth login führt einen OAuth-Flow im Browser aus und speichert eine Berechtigung, die an Ihren Workspace und dessen Region gebunden ist, sodass Sie keinen API-Schlüssel oder Host konfigurieren müssen. bird auth status gibt immer Exit-Code 0 zurück 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-Tool whoami zurückgibt.

Der Vertrag

JSON auf stdout; Fehler und Diagnosemeldungen auf stderr; niemals vermischt.
Exit-Codes: sechs semantische Codes, die Nutzungsfehler, Nicht-gefunden, Authentifizierung, Konflikte, vorübergehende Fehler und einen allgemeinen Fallback abdecken. Die vollständige Tabelle finden Sie unter CLI.
Mutationen nehmen Eingaben über Flags, einen JSON-Body via --body-file - (stdin) oder beides entgegen, wobei das Flag Vorrang hat.
--example gibt einen gültigen Request-Body aus, --dry-run zeigt eine Vorschau der Anfrage ohne Senden, und --idempotency-key macht einen Wiederholungsversuch sicher.

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 Ihrem Agenten beibringt.
CLI-Referenz: Alle Befehle, Flags und Ausgabeformate.
MCP-Server: Dieselbe Bird-Oberfläche als MCP-Tools, für Agenten, die Tools aufrufen statt eine Shell auszuführen.