Skip to main content

Introdução

kobana é a ferramenta de linha de comando das APIs dos produtos Kobana, o Gateway Bancário incluído. Ela é mantida em repositório próprio (kobana-cli) e os comandos de recurso não são escritos à mão: na inicialização, ela lê as specs OpenAPI embutidas no binário e monta a árvore de comandos a partir delas. Só os helpers +verbo são escritos à mão.

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

O CLI foi pensado tanto para pessoas quanto para agentes de IA: saída JSON por padrão, introspecção de schema, --dry-run e paginação automática.

Produtos​

ProdutoDescrição
bankingGateway Bancário: cobranças, pagamentos, transferências (API v1 e v2)
financeFinanceiro Inteligente: contas, lançamentos, fluxo de caixa
billingFaturamento Automático: assinaturas, planos, faturas
inboxInbox Autônomo: caixas de entrada, agentes, e-mails, webhooks

O produto banking fala com a mesma API documentada neste site, nas versões v1 e v2. A versão nunca entra no comando: /v1/bank_billets vira kobana banking bank-billets, e /v2/charge/pix vira kobana banking charge pix. Os recursos estão no catálogo.

Começando​

  1. Instale. Veja Instalação.

  2. Autentique-se com kobana auth login ou com um token em KOBANA_TOKEN. Veja Autenticação.

  3. Faça a primeira chamada, no sandbox:

    kobana banking bank-billets list --env sandbox --output-format table

  4. Explore a superfície. Todo comando aceita --help, e kobana schema mostra o caminho, os parâmetros e a descrição de qualquer endpoint sem sair do terminal.

CLI ou MCP?​

O CLI é para scripts, automações e agentes que rodam comandos de terminal. Para conectar um assistente de IA (Claude, ChatGPT, uma IDE) direto à conta, sem terminal, use o servidor MCP. Os dois chamam os mesmos recursos.

Próximos passos​