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 loginbird 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.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Anleitung ansehenSetting up your coding agentDas Konzept verstehenWhat is an MCP server, and how does an agent use one to send messages?Die Funktion erkundenCoding agentsDem Lernpfad folgenBuild with AI agents
Implementierungs-Briefing erhalten