Gateway Bancario
kobana banking
Cobros, pagos, transferencias y extracto, en las versiones v1 y v2 de la API.
kobana banking bank-billets list --output-format tableEl CLI kobana: la API de cada producto en tu terminal
Un solo binario para Gateway Bancario, Facturación Automática, Financiero Inteligente e Inbox Autónomo. Salida en JSON, --dry-run y paginación automática, para personas y para agentes.
Instalación
Homebrew, binario listo, Nix o desde el código fuente.
Homebrew (macOS y Linux)
brew tap universokobana/tap
brew install kobanaNix
nix run github:universokobana/kobana-cliDesde el código fuente
git clone https://github.com/universokobana/kobana-cli.git
cd kobana-cli
cargo install --path crates/kobana-cliRequiere Rust 1.86 o más reciente.
Binarios precompilados para Linux, macOS y Windows
Linux x86_64 / ARM64 · macOS Intel / Apple Silicon · Windows x86_64
Descargar en la página de ReleasesAutenticación y entornos
Inicio de sesión por el navegador para uso interactivo, token para scripts y CI.
# Inicio de sesión por el navegador (OAuth con PKCE)
kobana auth login
# O un token, para scripts y CI
export KOBANA_TOKEN=<token>
# Primera llamada, en el sandbox
kobana banking bank-billets list --env sandbox --output-format tableUn token por producto
KOBANA_TOKEN guarda la credencial de un producto a la vez. Un token del Gateway Bancario no autentica en Facturación, ni al revés.
Inbox Autónomo y mTLS
Inbox exige, además del token, un certificado de cliente. Apunta KOBANA_INBOX_CLIENT_CERT a un archivo PEM con el certificado y la clave.
Orden de resolución
KOBANA_TOKEN, después KOBANA_CREDENTIALS_FILE, después las credenciales guardadas por kobana auth login.
Producción es el valor por defecto
Solo el Gateway Bancario tiene sandbox: usa --env sandbox, o KOBANA_ENVIRONMENT=sandbox, para probar. Los tokens no valen entre entornos.
Un comando por producto
El árbol de comandos se arma al iniciar a partir de las especificaciones OpenAPI, así que el CLI refleja la API del producto.
Sintaxis: kobana <producto> <recurso> <método> [flags]
Facturación Automática
kobana billing
Suscripciones, planes, facturas y notas fiscales.
kobana billing subscriptions list --fields "id,status,plan_id"Financiero Inteligente
kobana finance
Cuentas por pagar y por cobrar, movimientos y flujo de caja.
kobana finance financial-accounts list --fields "id,name,balance"Inbox Autónomo
kobana inbox
Bandejas de entrada, correos, agentes, ejecuciones de agentes y webhooks. Además del token, Inbox Autónomo exige un certificado de cliente (mTLS): apunta KOBANA_INBOX_CLIENT_CERT a un PEM con el certificado y la clave.
kobana inbox emails list --fields "id,subject,received_at"Cobranza y Dashboard Mágico
Ninguno de los dos tiene producto en el CLI todavía. Usa la API REST.
Pensado para personas y para agentes
Salida en JSON
JSON por defecto, o tabla y CSV con --output-format. --fields limita las columnas.
--dry-run
Muestra el método, la URL y el cuerpo que se enviarían, sin ejecutar.
Paginación automática
--page-all devuelve un registro por línea (NDJSON), hasta 10 páginas por defecto.
Introspección de schema
kobana schema muestra la ruta, los parámetros y la descripción de cualquier endpoint sin salir de la terminal.
Idempotencia
Todo POST sale con X-Idempotency-Key. Pasa la tuya con --idempotency-key para repetir con seguridad.
Completions y actualización
Completions para Bash, Zsh, Fish y PowerShell, y kobana update para actualizar.
Helpers del Gateway Bancario
Atajos con flags con nombre para los flujos más comunes: +emitir, +cobrar y +cancelar-lote.
# Emitir un boleto
kobana +emitir --valor 150.50 --vencimento 2026-12-01 \
--nome "Maria Silva" --cpf-cnpj "012.345.678-90" --carteira 1 --dry-run¿CLI o MCP?
El CLI es para scripts, automatizaciones y agentes que ejecutan comandos de terminal. Para conectar un asistente de IA directo a la cuenta, sin terminal, usa el servidor MCP. Los dos llaman a los mismos recursos.
Ver los servidores MCPAutomatiza tus finanzas
Instala el CLI, haz la primera llamada en el sandbox y llévalo a tu pipeline.