CLI voor agents

De bird CLI is één binary, gebouwd om door een agent aangestuurd te worden. Uitvoer is standaard JSON, fouten gaan naar stderr en exitcodes geven de foutcategorie aan.

Aan de slag

De snelste route is je codeeragent instellen: plak één prompt en je agent installeert de CLI en de skills van Bird voor je. Handmatig installeren doe je zo:

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

bird auth login voert een OAuth-flow in de browser uit en slaat een grant op die aan je werkruimte en de regio ervan is gekoppeld, zodat je geen API-sleutel of host hoeft in te stellen. bird auth status eindigt altijd met 0 en meldt valid: true zodra het token werkt. bird whoami geeft de ingelogde gebruiker terug (ID, e-mail en naam). Dat is de identiteit waarmee de agent handelt en die de MCP whoami-tool teruggeeft.

Het contract

• JSON naar stdout; fouten en diagnostiek naar stderr; nooit gemengd.
• Exitcodes: zes semantische codes voor usage, not-found, auth, conflict, tijdelijke fouten en een algemene fallback. Bekijk de volledige tabel in CLI.
• Mutaties nemen invoer van flags, een JSON-body via --body-file - (stdin), of beide, waarbij de flag voorrang krijgt.
• --example toont een geldige request-body, --dry-run geeft een voorbeeld van het verzoek zonder het te versturen, en --idempotency-key maakt opnieuw proberen veilig.

Volgende stappen

• Je codeeragent instellen: plak een prompt en je agent installeert de CLI en skills.
• Agent-skills: wat elke skill je agent leert.
• CLI-referentie: elk commando, elke flag en uitvoervorm.
• MCP-server: hetzelfde Bird-oppervlak als MCP-tools, voor agents die tools aanroepen in plaats van een shell te draaien.