CLI para agentes
A CLI bird é 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.
Preparação
O caminho mais rápido é configurar seu agente de codificação: cole um prompt e seu agente instala a CLI e as skills 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 workspace e à sua região, de modo que você não precisa configurar uma chave de API ou host. bird auth status sempre retorna código de saída 0 e reporta valid: true quando o token está funcionando. bird whoami retorna o usuário autenticado (ID, email e nome), que é a identidade com a qual o agente atua e que a ferramenta MCP whoami retorna.
O contrato
- JSON para stdout; erros e diagnósticos para 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 tendo prioridade.
- --example imprime um corpo de requisição válido, --dry-run pré-visualiza a requisição sem enviá-la e --idempotency-key torna uma retentativa segura.
Próximos passos
- Configure seu agente de codificação: cole um prompt e seu agente instala a CLI e as skills.
- Skills de agente: o que cada skill ensina ao seu agente.
- Referência da CLI: todos os comandos, flags e formatos de saída.
- Servidor MCP: a mesma superfície do Bird como ferramentas MCP, para agentes que chamam ferramentas em vez de executar um shell.
Related resources
Continue with the documentation, guides and examples for this topic. Resources are in English.
Watch the guideSetting up your coding agentUnderstand the conceptWhat is an MCP server, and how does an agent use one to send messages?Explore the capabilityCoding agentsFollow the learning pathBuild with AI agents
Get an implementation brief