Sign inGet Started

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:
Codebeispiel
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.