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:
Exemplo de código
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth loginbird 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.
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Assista ao guiaSetting up your coding agentEntenda o conceitoWhat is an MCP server, and how does an agent use one to send messages?Explore a funcionalidadeCoding agentsSiga o percurso de aprendizagemBuild with AI agents
Obtenha um resumo de implementação