CLI Overview

The kolega-code command has two shapes:

No subcommand → launches the interactive Terminal UI.
A subcommand (ask, sessions, doctor, update) → runs a specific non-interactive task.

kolega-code [PROJECT_PATH] [options]      # interactive TUI
kolega-code ask "<prompt>" [options]       # one-shot prompt
kolega-code sessions <list|delete|export> [options]
kolega-code doctor [options]
kolega-code update

Commands

Command	What it does
`kolega-code .`	Launch the Textual TUI in the given project directory (default `.`)
`ask`	Run a single prompt and print the answer
`sessions`	List, delete, or export saved sessions
`doctor`	Check local configuration and API-key status
`update`	Update Kolega Code to the latest released version

Launching the TUI

kolega-code [PROJECT_PATH]

Argument / option	Description
`PROJECT_PATH`	Project directory to work in (default `.`)
`--new`	Start a new session (this is the default)
`--resume [THREAD_ID]`	Resume the latest saved thread, or a specific thread/session ID
`--browser-visible`	Launch visible Playwright browser windows instead of headless
`--permission-mode <auto\|ask>`	Shell/edit permission mode. TUI sessions default to `ask`
`--session <ID>`	Legacy alias for `--resume THREAD_ID`

See Sessions & Resuming for the full session workflow.

Global model options

These options are accepted by the TUI launch, ask, and doctor. They override environment variables and saved settings for the run.

Option	Description
`--provider`	Provider for the main coding model
`--model`	Main coding model
`--fast-provider`	Provider for fast utility calls
`--fast-model`	Fast utility model
`--thinking-provider`	Provider for think-hard operations
`--thinking-model`	Model for think-hard operations
`--thinking-effort`	Model-specific thinking effort, such as `auto`, `medium`, `high`, or `max`
`--environment`	Environment label for tracing/metadata

Session-state options

Option	Description
`--state-dir <PATH>`	Directory for CLI session state (defaults to the platform state directory)
`--session <ID>`	Session ID to resume or create

The default state directory and the KOLEGA_CODE_STATE_DIR override are described in Settings & API Keys.

Exit codes

Code	Meaning
`0`	Success
`2`	Configuration / usage error (e.g. invalid provider, missing API key, project path not found, Textual not installed)
`130`	Interrupted (`Ctrl+C`)