CLI para agentes

O bird CLI é um binário único projetado para ser controlado por um agente. A saída é JSON por padrão, erros vão para stderr e os códigos de saída indicam a categoria da falha.

Primeiros passos

O caminho mais rápido é configurar seu agente de código: cole um prompt e seu agente instala o CLI e as habilidades do Bird para você. Para instalar manualmente:

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

bird auth login executa um fluxo OAuth no navegador e armazena uma concessão vinculada ao seu espaço de trabalho e à região dele, dispensando a configuração de uma chave ou host de API. bird auth status sempre encerra com 0 e reporta valid: true quando o token funciona. bird whoami retorna o usuário autenticado (ID, email e nome), que é a identidade sob a qual o agente atua e que a ferramenta MCP whoami retorna.

O contrato

• JSON em stdout; erros e diagnósticos em stderr; nunca misturados.
• Códigos de saída: seis códigos semânticos cobrindo uso, não encontrado, autenticação, conflito, falhas transitórias e um fallback geral. Veja a tabela completa em CLI.
• Mutações recebem entrada de flags, um corpo JSON via --body-file - (stdin), ou ambos, com a flag prevalecendo.
• --example imprime um corpo de solicitação válido, --dry-run pré-visualiza a solicitação sem enviar e --idempotency-key torna seguro tentar novamente.

Próximos passos

• Configure seu agente de código: cole um prompt e seu agente instala o CLI e as habilidades.
• Habilidades do agente: o que cada habilidade ensina ao seu agente.
• Referência do CLI: todos os comandos, flags e formatos de saída.
• Servidor MCP: a mesma superfície Bird das ferramentas MCP, para agentes que chamam ferramentas em vez de executar um shell.