Gateway Bancário
kobana banking
Cobranças, pagamentos, transferências e extrato, nas versões v1 e v2 da API.
kobana banking bank-billets list --output-format tableO CLI kobana: a API de cada produto no seu terminal
Um binário só para Gateway Bancário, Faturamento Automático, Financeiro Inteligente e Inbox Autônomo. Saída em JSON, --dry-run e paginação automática, para pessoas e para agentes.
Instalação
Homebrew, binário pronto, Nix ou a partir do código-fonte.
Homebrew (macOS e Linux)
brew tap universokobana/tap
brew install kobanaNix
nix run github:universokobana/kobana-cliA partir do código-fonte
git clone https://github.com/universokobana/kobana-cli.git
cd kobana-cli
cargo install --path crates/kobana-cliRequer Rust 1.86 ou mais recente.
Binários pré-compilados para Linux, macOS e Windows
Linux x86_64 / ARM64 · macOS Intel / Apple Silicon · Windows x86_64
Baixar na página de ReleasesAutenticação e ambientes
Login pelo navegador para uso interativo, token para scripts e CI.
# Login pelo navegador (OAuth com PKCE)
kobana auth login
# Ou um token, para scripts e CI
export KOBANA_TOKEN=<token>
# Primeira chamada, no sandbox
kobana banking bank-billets list --env sandbox --output-format tableUm token por produto
KOBANA_TOKEN guarda a credencial de um produto por vez. Um token do Gateway Bancário não autentica no Faturamento, nem o contrário.
Inbox Autônomo e mTLS
O Inbox exige, além do token, um certificado de cliente. Aponte KOBANA_INBOX_CLIENT_CERT para um arquivo PEM com o certificado e a chave.
Ordem de resolução
KOBANA_TOKEN, depois KOBANA_CREDENTIALS_FILE, depois as credenciais salvas por kobana auth login.
Produção é o padrão
Só o Gateway Bancário tem sandbox: use --env sandbox, ou KOBANA_ENVIRONMENT=sandbox, para testar. Tokens não valem entre ambientes.
Um comando por produto
A árvore de comandos é montada na inicialização a partir das especificações OpenAPI, então o CLI reflete a API do produto.
Sintaxe: kobana <produto> <recurso> <método> [flags]
Faturamento Automático
kobana billing
Assinaturas, planos, faturas e notas fiscais.
kobana billing subscriptions list --fields "id,status,plan_id"Financeiro Inteligente
kobana finance
Contas a pagar e a receber, lançamentos e fluxo de caixa.
kobana finance financial-accounts list --fields "id,name,balance"Inbox Autônomo
kobana inbox
Caixas de entrada, e-mails, agentes, execuções de agentes e webhooks. Além do token, o Inbox Autônomo exige um certificado de cliente (mTLS): aponte KOBANA_INBOX_CLIENT_CERT para um PEM com o certificado e a chave.
kobana inbox emails list --fields "id,subject,received_at"Régua de Cobrança e Dashboard Mágico
Os dois ainda não têm produto no CLI. Use a API REST.
Pensado para pessoas e para agentes
Saída em JSON
JSON por padrão, ou tabela e CSV com --output-format. --fields limita as colunas.
--dry-run
Mostra o método, a URL e o corpo que seriam enviados, sem executar.
Paginação automática
--page-all devolve um registro por linha (NDJSON), em até 10 páginas por padrão.
Introspecção de schema
kobana schema mostra caminho, parâmetros e descrição de qualquer endpoint sem sair do terminal.
Idempotência
Todo POST sai com X-Idempotency-Key. Passe a sua com --idempotency-key para repetir com segurança.
Completions e atualização
Completions para Bash, Zsh, Fish e PowerShell, e kobana update para atualizar.
Helpers do Gateway Bancário
Atalhos com flags nomeadas para os fluxos mais comuns: +emitir, +cobrar e +cancelar-lote.
# Emitir um boleto
kobana +emitir --valor 150.50 --vencimento 2026-12-01 \
--nome "Maria Silva" --cpf-cnpj "012.345.678-90" --carteira 1 --dry-runCLI ou MCP?
O CLI é para scripts, automações e agentes que rodam comandos de terminal. Para conectar um assistente de IA direto à conta, sem terminal, use o servidor MCP. Os dois chamam os mesmos recursos.
Ver os servidores MCPAutomatize o seu financeiro
Instale o CLI, faça a primeira chamada no sandbox e leve para o seu pipeline.