Kobana shared

Skill universokobana/kobana-cli/skills/kobana-shared

Kobana CLI: Shared patterns for authentication, global flags, and output formatting.From its SKILL.md

Install

npx -y skills add universokobana/kobana-cli --skill kobana-shared

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

reads credentialsReads from 4 credential sources: `KOBANA_TOKEN` and 3 more.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 8 commands, including `brew tap universokobana/tap` and 7 more.

SKILL.md

2.8 KB, 715 tokens by cl100k_base, as published. Nobody here has run it

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 <ID> --client-secret <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 <FORMAT>`	Output format: `json` (default), `table`, `csv`
`--dry-run`	Validate and show request without calling the API
`--fields <FIELDS>`	Limit response fields (protects AI context windows)
`--env <ENV>`	API environment: `production` (default), `sandbox`, or `development`
`--verbose`	Show request/response details on stderr

CLI Syntax

kobana <service> <resource> <method> [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 <PATH>`	Save response to file
`--page-all`	Auto-paginate (NDJSON output)
`--page-limit <N>`	Max pages when using --page-all (default: 10)
`--page-delay <MS>`	Delay between pages in ms (default: 100)
`--idempotency-key <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 <endpoint> 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

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.