@kyma-api/gen

Agent-first CLI for Kyma API — search, run, and manage 51+ generative AI models from Claude Code, Cursor, Codex, or your terminal.

Status: scaffold. Command bodies are stubbed. Implementation lands slice by slice; the v0 surface is locked at 12 commands per kyma-api/.internal/specs/kyma-gen/cli-shape.md.

Install

curl https://kymaapi.com/install -fsS | bash

Or via npm:

npm install -g @kyma-api/gen

The kg short alias is auto-installed if kg is not already on your PATH (opt-out via --no-kg; force via --kg).

Quick start

kyma-gen setup                       # interactive: paste your ky-... key
kyma-gen models "logo design"        # search the catalog
kyma-gen run recraft-v4 --help       # introspect a model's input schema
kyma-gen run recraft-v4 --prompt "kyma wave" --download

Get a key at kymaapi.com/keys.

Surface (12 commands)

setup    Configure API key + preferences
init     Install the default kyma-gen skill bundle
skills   Manage installed skill bundles (list | install | update | remove)
models   Search/list models served by Kyma API
schema   Get a model's input/output schema
run      Run a model (sync or async)
status   Check job status / fetch result / cancel
upload   Upload a local file or URL to Kyma's storage
pricing  Get pricing for a model
docs     Search the kymaapi.com docs index
version  Show CLI version + check for known update
update   Self-update the binary

Run kyma-gen --help (or --json for the agent-readable schema) for the full surface.

Repository

Source lives in kyma-api/packages/kyma-gen. Behavior specs live in kyma-api/.internal/specs/kyma-gen (internal).

License

MIT