Introducción

kobana es una herramienta de línea de comandos única para las APIs de todos los productos Kobana — el Agente Kadu incluido. Se construye y mantiene en un repositorio propio (kobana-cli), no por este producto, y no tiene ningún endpoint escrito a mano: al iniciar lee las specs OpenAPI 3.1 embebidas en el binario y arma el árbol de comandos a partir de ellas. Actualizar la superficie de la API es cuestión de actualizar la spec embebida y publicar un build nuevo — ningún código por endpoint.

kobana <producto> <recurso> <metodo> [flags]

Pensada tanto para personas como para agentes de IA: salida JSON estructurada por defecto, introspección de schema, --dry-run y paginación automática. No tiene atajo que la API no tenga: token, scope, rol y límites son los de la API.

Productos

Producto	Descripción
banking	Gateway Bancario — cobros, pagos, transferencias (API v1 y v2)
finance	Financiero Inteligente — cuentas por pagar y por cobrar, movimientos, flujo de caja
billing	Facturación Automática — suscripciones, planes, facturas, facturas fiscales
inbox	Inbox Autónomo — bandejas de entrada, agentes, correos, webhooks
dunning	Régua de Cobranza — reglas, etapas y envíos
dashboards	Dashboard Mágico — dashboards y paneles
kadu	Agente Kadu — tareas, ejecuciones, pendientes, entornos, secrets, programaciones y webhooks

El producto kadu habla con la misma API documentada en este sitio. Sus recursos — vea el catálogo completo — apuntan a los mismos endpoints de la Referencia de la API; la CLI es solo otra forma de llamarla. No comparte credenciales con los demás productos: vea Autenticación.

Primeros pasos

1. Instale — vea Instalación.

2. Autentíquese en el producto que va a usar. Vea Autenticación.

3. Haga la primera llamada:

   kobana kadu tasks list --fields "id,skill_slug,label"

4. Explore la superficie — todo comando acepta --help, y kobana schema muestra los parámetros y el cuerpo de cualquier endpoint sin salir de la terminal.

Si el comando responde que kadu no es un producto, su versión de la CLI es anterior a Kadu: actualícela (kobana update o brew upgrade kobana).

Próximos pasos

• Instalación — Homebrew, binarios listos, Nix, build desde el source.
• Autenticación — tokens, entornos y las credenciales propias de kadu.
• Uso — sintaxis, recursos, ejemplos.
• Introspección de schema — kobana schema para parámetros y formato de solicitud y respuesta.
• Flags globales — las flags que todo comando acepta.
• Helpers — atajos +verbo para flujos comunes.
• Variables de entorno — autenticación, configuración y logs.
• Códigos de salida — códigos de salida del proceso, para scripts.