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 login

bird auth login startet einen OAuth-Flow im Browser und speichert eine Berechtigung, die an Ihren Workspace und dessen Region gebunden ist – Sie müssen keinen API-Schlüssel oder Host konfigurieren. 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.

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.
• --example gibt einen gültigen Request-Body aus, --dry-run zeigt den Request als Vorschau ohne Senden, und --idempotency-key macht eine Wiederholung 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 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.