CLI para agentes

El CLI bird es un binario único 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.

Configuración inicial

La forma más rápida es configurar tu agente de código: pega un prompt y tu agente instala el CLI y las habilidades de Bird por ti. Para instalarlo manualmente:

Ejemplo de código

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 workspace y su región, por lo que no necesitas configurar una clave API ni un host. bird auth status siempre sale con código 0 e informa valid: true una vez que el token funciona. bird whoami devuelve el usuario autenticado (ID, email 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 fallback general. Consulta la tabla completa en CLI.
Las mutaciones reciben entrada desde flags, un cuerpo JSON mediante --body-file - (stdin), o ambos, con prioridad del flag.
--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 el CLI y las habilidades.
Habilidades del agente: qué enseña cada habilidad a tu agente.
Referencia del CLI: todos los comandos, flags y formatos de salida.
Servidor MCP: la misma superficie de Bird como herramientas MCP, para agentes que invocan herramientas en lugar de ejecutar un shell.