CLI para agentes
bird CLI es un único binario diseñado para ser controlado por un agente. La salida es JSON por defecto, los errores van a stderr y los códigos de salida indican la categoría del fallo.
Configura el entorno
La vía más rápida es configurar tu agente de código: pega un prompt y tu agente instala CLI y las habilidades de Bird por ti. Para instalarlo a mano:
Ejemplo de código
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth loginbird auth login ejecuta un flujo OAuth en el navegador y almacena una concesión vinculada a tu espacio de trabajo y su región, así que no necesitas configurar una clave API ni un host. bird auth status siempre termina con 0 e informa valid: true cuando el token funciona. bird whoami devuelve el usuario autenticado (ID, correo electrónico y nombre), que es la identidad con la que actúa el agente y la que devuelve la herramienta MCP whoami.
El contrato
- JSON a stdout; errores y diagnósticos a stderr; nunca mezclados.
- Códigos de salida: seis códigos semánticos que cubren uso, no encontrado, autenticación, conflicto, fallos transitorios y un respaldo general. Consulta la tabla completa en CLI.
- Las mutaciones reciben entrada de flags, un cuerpo JSON mediante --body-file - (stdin), o ambos, y el flag prevalece.
- --example imprime un cuerpo de solicitud válido, --dry-run previsualiza la solicitud sin enviarla y --idempotency-key hace que un reintento sea seguro.
Próximos pasos
- Configura tu agente de código: pega un prompt y tu agente instala CLI y las habilidades.
- Habilidades de agente: lo que cada habilidad enseña a tu agente.
- Referencia de CLI: cada comando, flag y forma de salida.
- Servidor MCP: la misma superficie Bird que las herramientas MCP, para agentes que llaman herramientas en lugar de ejecutar un shell.
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.
Ver la guíaSetting up your coding agentComprender el conceptoWhat is an MCP server, and how does an agent use one to send messages?Explorar la funcionalidadCoding agentsSeguir la ruta de aprendizajeBuild with AI agents
Obtener un resumen de implementación