CLI dla agentów

bird CLI to pojedynczy plik binarny zaprojektowany do sterowania przez agenta. Wyjście jest domyślnie w formacie JSON, błędy trafiają na stderr, a kody wyjścia wskazują kategorię błędu.

Konfiguracja

Najszybsza droga to skonfigurowanie agenta kodującego: wklej jeden prompt, a agent zainstaluje CLI i umiejętności Bird za Ciebie. Aby zainstalować ręcznie:

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

bird auth login uruchamia w przeglądarce przepływ OAuth i zapisuje uprawnienie powiązane z Twoim obszarem roboczym i jego regionem, więc nie musisz konfigurować klucza API ani hosta. bird auth status zawsze kończy się kodem 0 i zgłasza valid: true, gdy token działa. bird whoami zwraca zalogowanego użytkownika (ID, e-mail i imię), czyli tożsamość, jako którą działa agent i którą zwraca narzędzie MCP whoami.

Kontrakt

• JSON na stdout; błędy i diagnostyka na stderr; nigdy razem.
• Kody wyjścia: sześć semantycznych kodów obejmujących użycie, not-found, auth, konflikt, błędy przejściowe i ogólny fallback. Pełna tabela w CLI.
• Mutacje przyjmują dane z flag, z 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 sprawia, że ponowienie jest bezpieczne.

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: każde polecenie, flaga i format wyjścia.
• Serwer MCP: ta sama powierzchnia Bird co narzędzia MCP, dla agentów wywołujących narzędzia zamiast uruchamiania powłoki.