Kobana Shared

kobana — Shared Reference

Installation

brew tap universokobana/tap
brew install kobana

Or download from Releases.

Authentication

# Token direto (mais simples)
export KOBANA_TOKEN=seu_token_aqui

# OAuth — Client Credentials
kobana auth login --client-id  --client-secret 

# OAuth — Authorization Code (abre browser)
export KOBANA_CLIENT_ID=seu_client_id
export KOBANA_CLIENT_SECRET=seu_client_secret
kobana auth login

Global Flags

| Flag | Description | |------|-------------| | --output-format | Output format: json (default), table, csv | | --dry-run | Validate and show request without calling the API | | --fields | Limit response fields (protects AI context windows) | | --env | API environment: production (default), sandbox, or development | | --verbose | Show request/response details on stderr |

CLI Syntax

kobana    [flags]

Method Flags

| Flag | Description | |------|-------------| | --params '{"key": "val"}' | URL/query parameters (id, uid, page, filters) | | --json '{"key": "val"}' | Request body for POST/PUT/PATCH | | --output | Save response to file | | --page-all | Auto-paginate (NDJSON output) | | --page-limit | Max pages when using --page-all (default: 10) | | --page-delay | Delay between pages in ms (default: 100) | | --idempotency-key | Custom idempotency key for mutations |

Security Rules

• Never output tokens or credentials directly
• Always use --dry-run before executing write/delete operations
• Always use --fields to limit response size and protect context windows
• Use kobana schema to inspect payloads before constructing them

JSON Tips

Wrap --params and --json values in single quotes so the shell does not interpret the inner double quotes:

kobana charge pix list --params '{"per_page": 5}'

Environment Variables

| Variable | Description | |----------|-------------| | KOBANA_TOKEN | Bearer access token (highest priority) | | KOBANA_CREDENTIALS_FILE | Path to OAuth credentials JSON file | | KOBANA_CLIENT_ID | OAuth client ID | | KOBANA_CLIENT_SECRET | OAuth client secret | | KOBANA_ENVIRONMENT | sandbox (default) or production | | KOBANA_CONFIG_DIR | Override config directory (default: ~/.config/kobana) |

Community & Feedback

• For bugs or feature requests: https://github.com/universokobana/kobana-cli/issues
• Security vulnerabilities: https://www.kobana.com.br/white-hat

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: universokobana
• Source: universokobana/kobana-cli
• License: MIT
• Homepage: https://www.kobana.com.br/ia/cli

Install and usage instructions live in the source repository linked above.