Installation

Requirements

• Python 3.11 or newer
• An API key for at least one supported provider

Install

Installer

curl -fsSL https://kolega.dev/install-kolega-code.sh | sh

uv

uv tool install kolega-code

From source

git clone https://github.com/kolega-ai/kolega-code.git
cd kolega-code
uv sync --extra dev
uv run kolega-code --version

Note

The installer supports macOS and Linux. On Windows, use WSL for the terminal UI or install directly with uv tool install kolega-code.

Verify the install

Once installed, confirm the CLI is on your PATH:

kolega-code --version

Then check your project configuration:

kolega-code doctor --project .

doctor reports your project path, where session state is stored, whether Textual is installed, your stored model selection, and whether the required API keys are present. See doctor for details.

Upgrade or uninstall

If you installed with the script or uv tool install, update the CLI with the built-in command:

kolega-code update

Running the installer again also updates an existing install to the latest released version. To uninstall, use uv:

uv tool uninstall kolega-code

Next steps

1. Install the CLI (above).

2. Add a provider/model and API key — either in the in-app Settings tab or via environment variables.

3. Run your first session — follow the Quick Start.