Introduction

Kolega Code is an AI coding agent that runs in your terminal. You point it at a project directory, and it opens an interactive UI where you can talk to an agent that can read and edit your code, run shell commands, search the codebase, browse the web, and dispatch specialized sub-agents to get work done.

It’s local-first: the agent operates on your actual filesystem and terminal, and your sessions, settings, and API keys are stored on your own machine.

What it does

• Reads and edits your code. The agent can open files, search across the codebase, create new files, and apply precise edits.
• Runs commands. It can execute shell commands and watch their output, with a dedicated terminal view in the UI.
• Plans before it builds. A read-only Plan mode produces a reviewable plan and a shared task list; Build mode implements it.
• Browses the web. A built-in browser agent (powered by Playwright) can fetch pages and interact with sites when a task needs it.
• Dispatches sub-agents. For larger tasks, the main agent can hand off to specialized agents (investigation, browser, coding, general) and track their activity live.
• Orchestrates workflows. With gigacode, the agent can fan out many sub-agents in parallel — for broad audits, large migrations, or implementing a plan’s independent parts at once.
• Works non-interactively too. Run a single prompt with kolega-code ask, get JSON output, and save or resume sessions.

Two ways to use it

Mode	Command	Best for
Interactive TUI	kolega-code .	Day-to-day development, exploration, pair-programming
One-shot	kolega-code ask "…"	Scripting, automation, quick questions, CI

There are also helper commands for managing sessions and checking your configuration.

Bring your own model

Kolega Code talks to a range of LLM providers — including Anthropic, OpenAI, Google, Moonshot, and DeepSeek — and lets you assign different models to different roles (a strong long-context model for coding, a fast cheap model for small utility calls, and one for extended “thinking”). See Providers & Models.

What you need

• Python 3.11+
• An API key for at least one supported provider
• A terminal that supports a modern TUI (most do)

Install

Install with the script:

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

Or with uv:

uv tool install kolega-code

Verify the install and start a session in your project:

kolega-code --version
kolega-code .

See Installation for requirements, other install methods, and upgrade/uninstall commands.

Next steps

Once you’re installed and have a provider key set, head to the Quick Start to run your first session.