# Kobana CLI - Acesse a API Kobana direto do terminal

Interface de linha de comando feita para humanos e agentes de IA. Acesse 9 serviços, autentique com segurança e automatize operações financeiras sem sair do terminal.

## Quick Start

```bash
# Instale via Homebrew
brew tap universokobana/tap
brew install kobana

# Configure suas credenciais
kobana auth login

# Liste suas cobranças Pix
kobana charge pix list --fields "id,amount,status"
```

## Sintaxe

```
kobana <servico> <recurso> <metodo> [flags]
```

### Exemplos

- Criar cobrança Pix: `kobana charge pix create --json '{"amount": 100}'`
- Listar transferências Pix: `kobana transfer pix list --page-all`
- Consultar saldo: `kobana financial account balance`
- Validar sem executar: `kobana payment pix create --json '...' --dry-run`

### Flags globais

- `--json '<JSON>'` - Body para POST/PUT/PATCH
- `--params '<JSON>'` - Parâmetros de query/URL
- `--fields '<CAMPOS>'` - Limitar campos da resposta
- `--dry-run` - Validar sem executar
- `--page-all` - Paginação automática (NDJSON)
- `--output-format` - Formato: json, table, csv
- `--sandbox` - Usar ambiente de testes
- `--output <PATH>` - Salvar resposta em arquivo

## Funcionalidades

- **Comandos dinâmicos**: Gerados automaticamente a partir do OpenAPI. A CLI sempre reflete a API mais recente sem precisar de atualização.
- **Dry-run e introspecção**: Valide requisições antes de executar com --dry-run. Inspecione endpoints e schemas sem documentação externa.
- **Múltiplos formatos de saída**: JSON, tabela ou CSV. Paginação automática com NDJSON e máscaras de campos para limitar dados retornados.
- **Autenticação segura**: Token, OAuth 2.0 (client credentials e authorization code). Credenciais criptografadas com AES-256-GCM e salvas no keyring do SO.

## Serviços

- **charge** - Cobranças Pix e Pix automático
- **payment** - Boletos, Pix, taxas e utilidades
- **transfer** - Pix, TED e transferências internas
- **financial** - Contas, saldos e extratos
- **admin** - Subcontas e gestão de usuários
- **data** - Consulta de boletos e QR Codes
- **mailbox** - EDI e gerenciamento de arquivos
- **security** - Tokens de acesso
- **v1** - API legada (boletos, clientes, webhooks)

## Projetada para humanos e máquinas

- **Saída estruturada**: JSON por padrão. Agentes processam a saída sem parsing complexo.
- **Máscaras de campos**: Use --fields para retornar apenas o necessário e evitar estourar a janela de contexto.
- **Validação segura**: Dry-run permite que o agente valide a operação antes de executar de fato.

## Instalação

### Homebrew (macOS e Linux)

```bash
brew tap universokobana/tap
brew install kobana
```

Atualizar: `brew update && brew upgrade kobana`

### Binários pré-compilados

Baixe o binário da [última release no GitHub](https://github.com/universokobana/kobana-cli/releases/latest):

- macOS (Apple Silicon): `kobana-darwin-arm64`
- macOS (Intel): `kobana-darwin-amd64`
- Linux (x86_64): `kobana-linux-amd64`
- Linux (ARM64): `kobana-linux-arm64`
- Windows (x86_64): `kobana-windows-amd64.exe`

### Código-fonte

```bash
git clone https://github.com/universokobana/kobana-cli.git
cd kobana-cli
cargo install --path crates/kobana-cli
```

## Links

- [GitHub](https://github.com/universokobana/kobana-cli)
- [Agendar bate-papo](/agendar)