Kyma Agent

Terminal-first coding agent powered by Kyma API.

Install one package, sign in once, and use many models through one balance.

Install

npm i -g @kyma-api/agent

On Windows, use npm install -g @kyma-api/agent in PowerShell or Windows Terminal. Do not use curl ... | bash.

This package installs:

• kyma for direct coding sessions
• kyma-ter for the local multi-agent workspace

Kyma Agent vs Kyma Ter

The package contains two related tools:

• kyma is the coding agent CLI
• kyma-ter is the browser-based local workspace for running many kyma and shell sessions in parallel

kyma-ter is distributed through this same package. The install step downloads the local kyma-ter binary automatically.

Usage

kyma                          # Interactive coding agent
kyma "explain this repo"      # Start with a prompt
kyma -p "fix the bug"         # One-shot mode (process and exit)
kyma -c                       # Continue previous session

Launch the workspace with:

kyma-ter

On Windows:

• kyma runs natively in PowerShell or Windows Terminal
• kyma-ter is available, with shell panes optimized for WSL2

First Run

kyma
# 1. Run /login to connect your Kyma account
# 2. Run /mode to choose your default mode
# 3. Start coding

Or start with kyma-ter if you want a local multi-pane workspace first.

Modes

Switch models by task type instead of memorizing model names:

kyma --mode fast               # Fastest response
kyma --mode coding             # Best for code
kyma --mode reasoning          # Deep thinking
kyma --mode cheap              # Lowest cost
kyma --mode vision             # Image support
kyma --mode long               # Long context

Or switch inside a session with /mode.

Current mode defaults include:

| Mode | Default model | |------|---------------| | coding | qwen-3-coder | | reasoning | deepseek-r1 | | cheap | gpt-oss-120b | | vision | gemma-4-31b | | long | kimi-k2.5 |

Commands

| Command | Description | |---------|-------------| | /login | Connect your Kyma account | | /logout | Sign out | | /models | Browse and switch models | | /mode | Switch model by task type | | /balance | Check credits and usage limits | | /status | Account, session, and API health | | /doctor | Run diagnostics | | /usage | Session cost and token usage | | /billing | Open billing page | | /dashboard | Open Kyma dashboard | | /upgrade | View tiers and upgrade | | /feedback | Report issues or give feedback |

Project Config

Create a KYMA.md at your project root to set per-project defaults:

---
model: qwen-3-coder
thinking: high
---

Kyma reads this on session start and applies the model and thinking level automatically.

Environment

| Variable | Description | |----------|-------------| | KYMA_API_KEY | API key (alternative to /login) | | KYMA_BASE_URL | Custom API base URL |

Windows Notes

• kyma is intended to run natively on Windows
• kyma-ter on Windows currently works best as a beta experience with WSL2 installed
• Run /doctor inside kyma to verify local setup, kyma-ter, and WSL detection

Docs

• Kyma Agent: docs.kymaapi.com/guides/agent
• Kyma Ter overview: docs.kymaapi.com/guides/kyma-ter/overview
• Kyma Ter quickstart: docs.kymaapi.com/guides/kyma-ter/quickstart

Pricing

All models are pay-per-token through your Kyma account. Free credits on signup. See kymaapi.com for pricing details.

Links

• Website: kymaapi.com
• Docs: docs.kymaapi.com
• Dashboard: kymaapi.com/dashboard

License

MIT