kolega-code 0.5.1__tar.gz → 0.6.0__tar.gz

kolega_code-0.6.0/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: kolega-code
+Version: 0.6.0
+Summary: Local-first AI coding agent for the terminal
+Project-URL: Homepage, https://kolega-ai.github.io/kolega-code/
+Project-URL: Documentation, https://kolega-ai.github.io/kolega-code/
+Project-URL: Repository, https://github.com/kolega-ai/kolega-code
+Project-URL: Issues, https://github.com/kolega-ai/kolega-code/issues
+Author: Kolega Team
+License: MIT License
+        
+        Copyright (c) 2026 Kolega Team
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: agent,ai,cli,coding-agent,developer-tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: anthropic==0.101.0
+Requires-Dist: beautifulsoup4==4.14.3
+Requires-Dist: google-genai==2.0.1
+Requires-Dist: jinja2==3.1.6
+Requires-Dist: langfuse==3.14.5
+Requires-Dist: nest-asyncio==1.6.0
+Requires-Dist: openai==1.109.1
+Requires-Dist: packaging==25.0
+Requires-Dist: pathspec==1.1.1
+Requires-Dist: playwright==1.59.0
+Requires-Dist: psutil==7.2.2
+Requires-Dist: pydantic==2.13.4
+Requires-Dist: python-dotenv==1.2.2
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: tenacity==9.1.4
+Requires-Dist: textual==8.2.5
+Requires-Dist: tiktoken==0.12.0
+Requires-Dist: trafilatura==2.0.0
+Provides-Extra: cli
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio==1.3.0; extra == 'dev'
+Requires-Dist: pytest==9.0.3; extra == 'dev'
+Requires-Dist: ruff==0.15.12; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Kolega Code
+
+**An AI coding agent that runs in your terminal — local-first, model-agnostic, plan-then-build.**
+
+[![PyPI version](https://img.shields.io/pypi/v/kolega-code)](https://pypi.org/project/kolega-code/)
+[![Python versions](https://img.shields.io/pypi/pyversions/kolega-code)](https://pypi.org/project/kolega-code/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![CI](https://github.com/kolega-ai/kolega-code/actions/workflows/ci.yml/badge.svg)](https://github.com/kolega-ai/kolega-code/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-kolega--ai.github.io-blue)](https://kolega-ai.github.io/kolega-code/)
+
+Point Kolega Code at a project directory and it opens an interactive UI where you 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 stay on your own machine.
+
+![Kolega Code in action](docs/src/assets/demo.gif)
+
+## Why Kolega Code
+
+- **Plans before it builds.** A read-only **Plan mode** produces a reviewable plan and a
+  shared task list before anything changes; **Build mode** implements it. Toggle with `Shift+Tab`.
+- **Orchestrates many agents.** For larger jobs, the main agent dispatches specialized
+  sub-agents (investigation, browser, coding, general) and can fan them out in parallel for
+  broad audits, large migrations, or implementing a plan's independent parts at once.
+- **Local-first by design.** It works on your real files and terminal; sessions, settings,
+  and credentials live on your machine, not in someone else's cloud.
+- **Bring your own model.** Talks to a range of providers and lets you assign different models
+  to different roles.
+
+## What it does
+
+- **Reads and edits your code.** Opens files, searches across the codebase, creates new files,
+  and applies precise edits.
+- **Runs commands.** Executes shell commands and watches their output in a dedicated terminal view.
+- **Plans before it builds.** Plan mode investigates and proposes; Build mode executes.
+- **Browses the web.** A built-in browser agent (powered by Playwright) fetches pages and
+  interacts with sites when a task needs it.
+- **Dispatches sub-agents.** Hands work off to specialized agents and tracks their activity live.
+- **Orchestrates workflows.** With [gigacode](https://kolega-ai.github.io/kolega-code/gigacode/),
+  it fans out many sub-agents in parallel.
+- **Works non-interactively too.** Run a single prompt with `kolega-code ask`, get JSON output,
+  and save or resume sessions.
+
+## Quick start
+
+**1. Install** with the script:
+
+```bash
+curl -fsSL https://kolega.dev/install-kolega-code.sh | sh
+```
+
+Or with [uv](https://docs.astral.sh/uv/) (or `pip`):
+
+```bash
+uv tool install kolega-code
+# or: pip install kolega-code
+```
+
+Verify the install:
+
+```bash
+kolega-code --version
+```
+
+**2. Start a session** in your project:
+
+```bash
+kolega-code .
+```
+
+**3. Add a provider key.** Open the **Settings** tab to pick a provider and model and save your
+API key. Then press `Shift+Tab` anytime to switch between **Plan** and **Build** mode.
+
+Resume a previous conversation:
+
+```bash
+kolega-code . --resume            # latest session
+kolega-code . --resume <id>       # a specific thread or session
+```
+
+## 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 setup:
+
+```bash
+kolega-code ask "summarize this repository" --project .
+kolega-code sessions list --project .
+kolega-code doctor --project .
+```
+
+## 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](https://kolega-ai.github.io/kolega-code/configuration/providers-and-models/).
+
+## Configuration
+
+Set your provider, model, and API keys from the **Settings** tab in the UI, or via environment
+variables and flags for non-interactive use:
+
+```bash
+export KOLEGA_CODE_PROVIDER=deepseek
+export DEEPSEEK_API_KEY=...
+kolega-code ask "summarize this repository" --project . --provider deepseek --model deepseek-v4-pro
+```
+
+API key variables only provide credentials — pick a provider/model explicitly or save one in
+Settings. Local session state lives under your platform's state directory unless
+`KOLEGA_CODE_STATE_DIR` is set. See the
+[Configuration docs](https://kolega-ai.github.io/kolega-code/configuration/settings-and-api-keys/)
+for the full story.
+
+## Requirements
+
+- **Python 3.11+**
+- An **API key** for at least one supported provider
+- A terminal that supports a modern TUI (most do)
+
+## Documentation
+
+Full documentation lives at **[kolega-ai.github.io/kolega-code](https://kolega-ai.github.io/kolega-code/)**:
+
+- [Quick Start](https://kolega-ai.github.io/kolega-code/getting-started/quick-start/)
+- [CLI overview](https://kolega-ai.github.io/kolega-code/cli/overview/)
+- [How it works & concepts](https://kolega-ai.github.io/kolega-code/concepts/how-it-works/)
+- [Configuration](https://kolega-ai.github.io/kolega-code/configuration/settings-and-api-keys/)
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for local setup, running the
+test suite, and building the docs site. Please report security issues privately per
+[SECURITY.md](SECURITY.md).
+
+## License
+
+Released under the [MIT License](LICENSE).

kolega_code-0.6.0/README.md

@@ -0,0 +1,145 @@
+# Kolega Code
+
+**An AI coding agent that runs in your terminal — local-first, model-agnostic, plan-then-build.**
+
+[![PyPI version](https://img.shields.io/pypi/v/kolega-code)](https://pypi.org/project/kolega-code/)
+[![Python versions](https://img.shields.io/pypi/pyversions/kolega-code)](https://pypi.org/project/kolega-code/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![CI](https://github.com/kolega-ai/kolega-code/actions/workflows/ci.yml/badge.svg)](https://github.com/kolega-ai/kolega-code/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-kolega--ai.github.io-blue)](https://kolega-ai.github.io/kolega-code/)
+
+Point Kolega Code at a project directory and it opens an interactive UI where you 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 stay on your own machine.
+
+![Kolega Code in action](docs/src/assets/demo.gif)
+
+## Why Kolega Code
+
+- **Plans before it builds.** A read-only **Plan mode** produces a reviewable plan and a
+  shared task list before anything changes; **Build mode** implements it. Toggle with `Shift+Tab`.
+- **Orchestrates many agents.** For larger jobs, the main agent dispatches specialized
+  sub-agents (investigation, browser, coding, general) and can fan them out in parallel for
+  broad audits, large migrations, or implementing a plan's independent parts at once.
+- **Local-first by design.** It works on your real files and terminal; sessions, settings,
+  and credentials live on your machine, not in someone else's cloud.
+- **Bring your own model.** Talks to a range of providers and lets you assign different models
+  to different roles.
+
+## What it does
+
+- **Reads and edits your code.** Opens files, searches across the codebase, creates new files,
+  and applies precise edits.
+- **Runs commands.** Executes shell commands and watches their output in a dedicated terminal view.
+- **Plans before it builds.** Plan mode investigates and proposes; Build mode executes.
+- **Browses the web.** A built-in browser agent (powered by Playwright) fetches pages and
+  interacts with sites when a task needs it.
+- **Dispatches sub-agents.** Hands work off to specialized agents and tracks their activity live.
+- **Orchestrates workflows.** With [gigacode](https://kolega-ai.github.io/kolega-code/gigacode/),
+  it fans out many sub-agents in parallel.
+- **Works non-interactively too.** Run a single prompt with `kolega-code ask`, get JSON output,
+  and save or resume sessions.
+
+## Quick start
+
+**1. Install** with the script:
+
+```bash
+curl -fsSL https://kolega.dev/install-kolega-code.sh | sh
+```
+
+Or with [uv](https://docs.astral.sh/uv/) (or `pip`):
+
+```bash
+uv tool install kolega-code
+# or: pip install kolega-code
+```
+
+Verify the install:
+
+```bash
+kolega-code --version
+```
+
+**2. Start a session** in your project:
+
+```bash
+kolega-code .
+```
+
+**3. Add a provider key.** Open the **Settings** tab to pick a provider and model and save your
+API key. Then press `Shift+Tab` anytime to switch between **Plan** and **Build** mode.
+
+Resume a previous conversation:
+
+```bash
+kolega-code . --resume            # latest session
+kolega-code . --resume <id>       # a specific thread or session
+```
+
+## 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 setup:
+
+```bash
+kolega-code ask "summarize this repository" --project .
+kolega-code sessions list --project .
+kolega-code doctor --project .
+```
+
+## 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](https://kolega-ai.github.io/kolega-code/configuration/providers-and-models/).
+
+## Configuration
+
+Set your provider, model, and API keys from the **Settings** tab in the UI, or via environment
+variables and flags for non-interactive use:
+
+```bash
+export KOLEGA_CODE_PROVIDER=deepseek
+export DEEPSEEK_API_KEY=...
+kolega-code ask "summarize this repository" --project . --provider deepseek --model deepseek-v4-pro
+```
+
+API key variables only provide credentials — pick a provider/model explicitly or save one in
+Settings. Local session state lives under your platform's state directory unless
+`KOLEGA_CODE_STATE_DIR` is set. See the
+[Configuration docs](https://kolega-ai.github.io/kolega-code/configuration/settings-and-api-keys/)
+for the full story.
+
+## Requirements
+
+- **Python 3.11+**
+- An **API key** for at least one supported provider
+- A terminal that supports a modern TUI (most do)
+
+## Documentation
+
+Full documentation lives at **[kolega-ai.github.io/kolega-code](https://kolega-ai.github.io/kolega-code/)**:
+
+- [Quick Start](https://kolega-ai.github.io/kolega-code/getting-started/quick-start/)
+- [CLI overview](https://kolega-ai.github.io/kolega-code/cli/overview/)
+- [How it works & concepts](https://kolega-ai.github.io/kolega-code/concepts/how-it-works/)
+- [Configuration](https://kolega-ai.github.io/kolega-code/configuration/settings-and-api-keys/)
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for local setup, running the
+test suite, and building the docs site. Please report security issues privately per
+[SECURITY.md](SECURITY.md).
+
+## License
+
+Released under the [MIT License](LICENSE).

{kolega_code-0.5.1 → kolega_code-0.6.0}/docs/src/content/docs/configuration/environment-variables.md

@@ -67,6 +67,19 @@ provider's default model, or set both provider and model.
 
 See [Providers & Models](../providers-and-models/) for what each role does.
 
+## Per-agent models
+
+Give an individual agent its own model. `<ROLE>` is one of `PLANNING`, `BUILDING`,
+`INVESTIGATION`, `GENERAL`, or `BROWSER`. A role with no override inherits the main
+model. These also override anything saved in the Settings tab's **Agent Models**
+section.
+
+| Variable | Purpose |
+| --- | --- |
+| `KOLEGA_CODE_<ROLE>_PROVIDER` | Provider for that agent (e.g. `KOLEGA_CODE_INVESTIGATION_PROVIDER`) |
+| `KOLEGA_CODE_<ROLE>_MODEL` | Model for that agent |
+| `KOLEGA_CODE_<ROLE>_EFFORT` | Thinking effort for that agent |
+
 ## State & environment
 
 | Variable | Purpose |

{kolega_code-0.5.1 → kolega_code-0.6.0}/docs/src/content/docs/configuration/providers-and-models.mdx

@@ -102,6 +102,42 @@ kolega-code . \
 Or with environment variables — see
 [Environment Variables](../environment-variables/) for the complete list.
 
+## Per-agent models
+
+The three slots above describe *operational* roles (main, fast, thinking). Separately,
+you can give each **agent** its own model, so a cheap, fast model handles
+investigation while a stronger model does the building. This applies to top-level
+agents and to the sub-agents they dispatch.
+
+| Agent role | Key | Runs |
+| --- | --- | --- |
+| **Planning** | `planning` | The plan-mode agent |
+| **Building** | `building` | The main coder agent |
+| **Investigation** | `investigation` | Read-only research/exploration sub-agents |
+| **General** | `general` | General-purpose sub-agents |
+| **Browser** | `browser` | Browser/web sub-agents |
+
+Each role **inherits the active (long-context) model** unless you give it an override —
+so with nothing configured, behavior is unchanged.
+
+In the **Settings tab**, the **Agent Models** section (below the main Model section)
+has a provider/model/effort group per role. Leave a role on **Default** to inherit;
+pick a provider, model, and thinking effort to override it.
+
+Or use environment variables, named `KOLEGA_CODE_<ROLE>_PROVIDER` / `_MODEL` / `_EFFORT`:
+
+```bash
+# Use a fast model for investigation; everything else uses the active model.
+export KOLEGA_CODE_INVESTIGATION_PROVIDER=deepseek
+export KOLEGA_CODE_INVESTIGATION_MODEL=deepseek-v4-flash
+export KOLEGA_CODE_INVESTIGATION_EFFORT=high
+```
+
+Resolution order for a role (first match wins): **env var → saved Settings → the
+active model**. Each override's provider must have an API key, exactly like the main
+roles. (Inside a `run_workflow` script, an explicit `model=`/`effort=` on an `agent()`
+call still takes precedence over these per-role defaults.)
+
 ## Thinking effort
 
 Thinking effort is model-specific. Kolega Code validates the selected value

{kolega_code-0.5.1 → kolega_code-0.6.0}/docs/src/content/docs/configuration/settings-and-api-keys.mdx

@@ -21,12 +21,17 @@ the TUI:
 
 When you switch models, the thinking effort resets to the new model's default.
 
-A saved selection is used for **all** agent model roles. Existing environment
+A saved selection is the default for **all** agent model roles. Existing environment
 variables and `--provider` / `--model` flags continue to override it — see
 [Providers & Models](../providers-and-models/) for resolution order.
 API key environment variables are credentials only; they do not choose the active
 provider or model.
 
+The **Agent Models** section beneath the main Model section lets you give individual
+agents (planning, building, investigation, general, browser) their own provider,
+model, and effort. Leave a role on **Default** to inherit the active model. See
+[Per-agent models](../providers-and-models/#per-agent-models).
+
 ## Where settings live
 
 Settings are stored as JSON in your platform's state directory, in a file named
@@ -45,16 +50,28 @@ The file looks like this:
 
 ```json
 {
-  "schema_version": 2,
+  "schema_version": 3,
   "active_provider": "moonshot",
   "active_model": "kimi-k2.7-code",
   "active_thinking_effort": "auto",
   "api_keys": {
-    "moonshot": "sk-..."
+    "moonshot": "sk-...",
+    "deepseek": "sk-..."
+  },
+  "agent_models": {
+    "investigation": {
+      "provider": "deepseek",
+      "model": "deepseek-v4-flash",
+      "thinking_effort": "high"
+    }
   }
 }
 ```
 
+`agent_models` holds per-agent overrides keyed by role (`planning`, `building`,
+`investigation`, `general`, `browser`); a role that is absent inherits the active
+model. The field is optional and older `schema_version` files load unchanged.
+
 <Aside type="caution" title="Keys are stored in plaintext">
 API keys are written to `settings.json` in plaintext, but the file is created with
 `0600` permissions (readable and writable only by your user). If you'd rather not

{kolega_code-0.5.1 → kolega_code-0.6.0}/kolega_code/__init__.py

@@ -148,4 +148,4 @@ __all__ = [
     "parse_git_status_output",
 ]
 
-__version__ = "0.5.1"
+__version__ = "0.6.0"

{kolega_code-0.5.1 → kolega_code-0.6.0}/kolega_code/agent/__init__.py

@@ -39,4 +39,4 @@ __all__ = [
     "ToolExtension",
 ]
 
-__version__ = "0.5.1"
+__version__ = "0.6.0"