Skip to main content
Use this guide if:
  • you are on Windows
  • you want the shortest install path
  • you want commands an agent can copy and run directly

​
Install

Open PowerShell or Windows Terminal, then run: 
npm install -g @kyma-api/agent
This installs:
  • kyma
  • kyma-ter

​
Verify Install

Run: 
kyma --version
kyma-ter --version
Expected:
  • kyma should print the current package version
  • kyma-ter should print the current runtime version

​
First Run

Start Kyma Agent: 
kyma
Then inside kyma: 
/login
After login, you can check local diagnostics: 
/doctor

​
Launch Kyma Ter

Run: 
kyma-ter
Kyma Ter opens the local workspace in your browser. Windows binaries are published on GitHub Releases in kyma-api/kyma-ter. Use:
  • kyma natively in PowerShell or Windows Terminal
  • kyma-ter with WSL2 for the best shell-pane experience
Check whether WSL is available: 
wsl --status
If WSL is installed, kyma-ter will prefer WSL-backed shell panes on Windows.

​
If kyma-ter Is Missing

Reinstall from a network-enabled shell: 
npm install -g @kyma-api/agent
Then verify again: 
kyma-ter --version
If you need to verify that the Windows release asset exists, check:

​
If You Need Diagnostics

Start kyma and run: 
/doctor
Use this to check:
  • local config
  • kyma-ter binary
  • Windows runtime state
  • WSL detection

​
Minimal Copy-Paste Flow

npm install -g @kyma-api/agent
kyma --version
kyma-ter --version
kyma
Then inside kyma: 
/login
/doctor
Then back in PowerShell: 
kyma-ter