CLI dla agentów

bird CLI to pojedynczy plik binarny stworzony do sterowania przez agenta. Domyślnym formatem wyjścia jest JSON, błędy trafiają na stderr, a kody zakończenia wskazują kategorię błędu.

Konfiguracja

Najszybszą ścieżką jest skonfigurowanie agenta kodującego: wklej jeden prompt, a agent zainstaluje za Ciebie CLI oraz umiejętności Bird. Aby zainstalować ręcznie:

Przykład kodu

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

bird auth login uruchamia przepływ OAuth w przeglądarce i zapisuje uprawnienia powiązane z Twoim workspace'em i jego regionem, dzięki czemu nie musisz konfigurować klucza API ani hosta. bird auth status zawsze zwraca kod 0 i raportuje valid: true, gdy token działa. bird whoami zwraca zalogowanego użytkownika (ID, e-mail i nazwę) — jest to tożsamość, pod którą działa agent, i którą zwraca narzędzie MCP whoami.

Kontrakt

JSON na stdout; błędy i diagnostyka na stderr; nigdy nie są mieszane.
Kody zakończenia: sześć semantycznych kodów obejmujących błędy użycia, nie znaleziono, uwierzytelniania, konfliktu, awarii przejściowych oraz ogólny kod zastępczy. Pełna tabela w CLI.
Mutacje przyjmują dane z flag, treści JSON przez --body-file - (stdin) lub z obu źródeł, przy czym flaga ma pierwszeństwo.
--example wypisuje prawidłową treść żądania, --dry-run wyświetla podgląd żądania bez wysyłania, a --idempotency-key zapewnia bezpieczne ponawianie.

Następne kroki

Skonfiguruj agenta kodującego: wklej prompt, a agent zainstaluje CLI i umiejętności.
Umiejętności agenta: czego każda umiejętność uczy Twojego agenta.
Dokumentacja CLI: wszystkie polecenia, flagi i formaty wyjścia.
Serwer MCP: ta sama powierzchnia Bird jako narzędzia MCP, dla agentów wywołujących narzędzia zamiast uruchamiania powłoki.