Introducción
kobana es una única herramienta de línea de comandos para la API de todos los productos de Kobana — incluido Inbox Autónomo. Se construye y mantiene en su propio repositorio (kobana-cli), no por este producto, y no tiene endpoints fijos en el código: al iniciar, interpreta las specs OpenAPI 3.1 embebidas en el binario y arma su árbol de comandos a partir de ellas. Actualizar la superficie de la API es cuestión de refrescar la spec embebida y publicar un nuevo build — sin código por endpoint.
kobana <producto> <recurso> <método> [flags]
Diseñado para humanos y agentes de IA: salida JSON estructurada por defecto, introspección de schema, --dry-run y paginación automática.
Productos
| Producto | Descripción | Estado |
|---|---|---|
banking | Gateway Bancario — cobros, pagos, transferencias (API v1 y v2) | Disponible |
inbox | Inbox Autónomo — inboxes, agents, correos, webhooks (esta API) | Disponible |
finance | Finanzas Inteligentes — cuentas por pagar y por cobrar, movimientos, flujo de caja | Disponible |
billing | Facturación Automática — suscripciones, planes, facturas, notas fiscales | Disponible |
El producto inbox habla con la misma API documentada en este sitio. Sus recursos — workspaces, inboxes, emails, agents, agent-runs, webhooks, system-events — se corresponden directamente con los Modelos y Recursos de la Referencia de la API; el CLI es solo otra forma de llamarla. No comparte credenciales ni transporte con banking — ver Autenticación.
Primeros pasos
-
Instálalo — ver Instalación.
-
Autentícate para el producto que necesitas — un token Bearer para
inbox, OAuth o un token parabanking. Ver Autenticación. -
Haz tu primera llamada:
kobana inbox workspaces list --fields "id,name" -
Explora la superficie — todo comando acepta
--help, ykobana schemaintrospecciona los parámetros y el cuerpo de cualquier endpoint sin salir de la terminal.
Próximos pasos
- Instalación — Homebrew, binarios precompilados, Nix, build desde el código fuente.
- Autenticación — tokens, OAuth, entornos, las credenciales propias del producto
inbox. - Uso — sintaxis, productos, recursos, ejemplos.
- Introspección de schema —
kobana schemapara parámetros y forma de request/response. - Flags globales — las flags que acepta todo comando.
- Helpers — atajos
+verbopara flujos comunes. - Variables de entorno — autenticación, configuración y logging.
- Códigos de salida — códigos de salida del proceso para scripts.