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:

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

bird 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.