Kobana
Open Source

All banking operations from your terminal

A command-line interface built for humans and AI agents. Access 9 services, authenticate securely, and automate financial operations without leaving the terminal.

Quick Start

Install and configure in seconds:

# Install via Homebrew
brew tap universokobana/tap
brew install kobana
# Configure your credentials
kobana auth login
# List your Pix charges
kobana charge pix list --fields "id,amount,status"
Syntax

Simple and predictable

The same structure for all commands. Easy to memorize, easy to automate.

kobana <service> <resource> <method> [flags]

Create Pix charge

kobana charge pix create --json '{"amount": 100}'

List Pix transfers

kobana transfer pix list --page-all

Check balance

kobana financial account balance

Validate without executing

kobana payment pix create --json '...' --dry-run

Global flags

Available in all commands.

--json '<JSON>'Body for POST/PUT/PATCH
--params '<JSON>'Query/URL parameters
--fields '<FIELDS>'Limit response fields
--dry-runValidate without executing
--page-allAuto-pagination (NDJSON)
--output-formatFormat: json, table, csv
--sandboxUse test environment
--output <PATH>Save response to file
Features

Built for automation

Every detail designed to integrate with scripts, CI/CD pipelines, and AI agents.

Dynamic commands

Auto-generated from OpenAPI specs. The CLI always reflects the latest API without needing updates.

Dry-run and introspection

Validate requests before executing with --dry-run. Inspect endpoints and schemas without external docs.

Multiple output formats

JSON, table or CSV. Automatic pagination with NDJSON and field masks to limit returned data.

Secure authentication

Token, OAuth 2.0 (client credentials and authorization code). Credentials encrypted with AES-256-GCM and stored in OS keyring.

9 Services

Complete API coverage

All Kobana API services available as terminal commands.

charge

Pix charges and automatic Pix

payment

Boletos, Pix, fees and utilities

transfer

Pix, TED and internal transfers

financial

Accounts, balances and statements

admin

Sub-accounts and user management

data

Boleto and QR Code lookups

mailbox

EDI and file management

security

Access tokens

v1

Legacy API (boletos, customers, webhooks)

For AI Agents

Designed for humans and machines

The Kobana CLI was built from the ground up to work seamlessly with AI agents.

Structured output

JSON by default. Agents process the output without complex parsing.

Field masks

Use --fields to return only what you need and avoid blowing up the context window.

Safe validation

Dry-run lets the agent validate the operation before actually executing it.

Installation

Install in seconds

Pre-compiled binaries for Linux, macOS and Windows. Or build from source.

Homebrew

The simplest way to install on macOS and Linux.

brew tap universokobana/tap
brew install kobana

Update

brew update && brew upgrade kobana

Ready to operate from the terminal?

Kobana CLI is open source and free. Start automating your financial operations now.