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 loginbird 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.
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