# Kobana Shared

> Kobana CLI: Shared patterns for authentication, global flags, and output formatting.

- **Type:** Skill
- **Install:** `agentstack add skill-universokobana-kobana-cli-kobana-shared`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [universokobana](https://agentstack.voostack.com/s/universokobana)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [universokobana](https://github.com/universokobana)
- **Source:** https://github.com/universokobana/kobana-cli/tree/main/skills/kobana-shared
- **Website:** https://www.kobana.com.br/ia/cli

## Install

```sh
agentstack add skill-universokobana-kobana-cli-kobana-shared
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# kobana — Shared Reference

## Installation

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

Or download from [Releases](https://github.com/universokobana/kobana-cli/releases/latest).

## Authentication

```bash
# 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

```bash
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:

```bash
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](https://github.com/universokobana)
- **Source:** [universokobana/kobana-cli](https://github.com/universokobana/kobana-cli)
- **License:** MIT
- **Homepage:** https://www.kobana.com.br/ia/cli

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-universokobana-kobana-cli-kobana-shared
- Seller: https://agentstack.voostack.com/s/universokobana
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.