Kolega Code — Multi-agent coding in your terminal

3 min read Original article ↗
 ██  ██   ██████  ██      ███████  ██████   █████
 ██ ██   ██    ██ ██      ██      ██       ██   ██
 ████    ██    ██ ██      █████   ██   ███ ███████
 ██ ██   ██    ██ ██      ██      ██    ██ ██   ██
 ██  ██   ██████  ███████ ███████  ██████  ██   ██
  ██████  ██████  ██████  ███████
 ██      ██    ██ ██   ██ ██
 ██      ██    ██ ██   ██ █████
 ██      ██    ██ ██   ██ ██
  ██████  ██████  ██████  ███████

Local-first. Provider-agnostic. Open source. Kolega Code fans out specialized sub-agents with Gigacode, routes different models to different jobs, searches the web, drives a browser, and keeps your sessions, settings, permissions, and credentials on your machine.

kolega-code . · Kolega Code in actionREC

Kolega Code terminal session

# install

One command. Then bring your own keys.

script

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

uv

uv tool install kolega-code

pip

pip install kolega-code

verify · kolega-code --versionstart · kolega-code .requires · Python 3.11+

providers

AnthropicOpenAIChatGPT sign-inGoogleGroqTogether.aiFireworks.aixAI / GrokDeepSeekQwenKimiZ.AI / GLMOllamalocal Llama

Have a paid ChatGPT plan? Run /login chatgpt to use OpenAI models without a separate API key. Web search uses DuckDuckGo by default, no key required.

FLAGSHIP CAPABILITY

Gigacode

Spawn a whole engineering team in your terminal.

One command fans out a coordinated org of specialized sub-agents. A planner breaks down the work, coders build features in parallel, investigators read the codebase, and a judge reviews and synthesizes. Pipelines, loops, and review panels run as scripted, resumable workflows with every artifact saved to disk.

parallel fan-outjudge & synthesisresumablesaved artifacts

/gigacode onthen describe the project

org · 1 lead → 5 agents · live

plannerdecomposed · 7 tasks

coder · auth + billingbuilding

coder · notificationsbuilding

investigator · repo mapdone

judgereview → synthesize

# everything else it does

Built for work one agent cannot cover.

sub-agents

Specialized sub-agents

Planning, coder, investigation, general, and browser agents, with live activity tracking in the Textual TUI.

plan / build

Plan / build workflow

Read-only Plan mode for investigation and a reviewable task list; Build mode to implement. Toggle with Shift+Tab.

routing

Model routing

Assign different models to long-context, fast, and thinking roles, and override the model per agent role.

web + browser

Web search & browsing

DuckDuckGo by default (no key); Firecrawl, Tavily, or SearXNG. Plus a Playwright browser agent for interactive sites.

local-first

Local-first & scriptable

State stays on your machine. Use the TUI, or run kolega-code ask for one-shot, JSON output, and CI.

# live proof

Show, don't tell.

kolega-code ask "audit ./src" --project .

$ kolega-code ask "audit ./src for security issues" --project .

⊢ investigation agent · scanning 142 files (read-only)

! src/auth/session.py : missing CSRF check

! src/db/query.py : string-built SQL (injection risk)

→ 2 findings, ranked · transcript saved to state dir

→ switch to Build mode (Shift+Tab) to apply fixes

# why local-first

Your machine. Your keys. No lock-in.

Sessions, settings, permissions, OAuth tokens, and API-key settings stay on your machine, with restrictive file permissions where applicable. Bring your own key or run a local model.

Where state liveslocal state dir

Model keysyours · BYO

ChatGPT tokenslocal · chmod 600

Lock-innone · open source

# comparison

vs single-agent terminal tools

Kolega Codesingle-agent CLI

Agents per taskmultiple, coordinatedone

Model providersmany · per roleusually one

Statelocal-firstcloud / ephemeral

Browser automationPlaywright agentrare

Parallel workGigacode fan-outno

LicenceApache-2.0often closed

Kolega Code is part of a connected toolchain. Build visually in Studio, take full control here, secure it with DevSec or open-source Kolega Scan, built by one team to work together.

Open source from Kolega Labs →