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

kolega_code-0.7.0/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: kolega-code
+Version: 0.7.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: ddgs==9.14.4
+Requires-Dist: firecrawl-py==4.28.2
+Requires-Dist: google-genai==2.0.1
+Requires-Dist: httpx==0.28.1
+Requires-Dist: jinja2==3.1.6
+Requires-Dist: langfuse==3.14.5
+Requires-Dist: lxml-html-clean==0.4.4
+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: tavily-python==0.7.26
+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.
+- **Searches and browses the web.** The agent can search for relevant pages, fetch URLs
+  directly, or use the built-in browser agent (powered by Playwright) when a task needs
+  site interaction.
+- **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.
+
+The `web_search` tool uses DuckDuckGo by default without a key. To choose another backend,
+set it in **Settings** or export `KOLEGA_CODE_WEB_SEARCH_BACKEND` as `firecrawl`, `tavily`,
+or `searxng`; use `FIRECRAWL_API_KEY`, `TAVILY_API_KEY`, or `SEARXNG_BASE_URL` as needed.
+
+## 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.7.0/README.md

@@ -0,0 +1,150 @@
+# 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.
+- **Searches and browses the web.** The agent can search for relevant pages, fetch URLs
+  directly, or use the built-in browser agent (powered by Playwright) when a task needs
+  site interaction.
+- **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.
+
+The `web_search` tool uses DuckDuckGo by default without a key. To choose another backend,
+set it in **Settings** or export `KOLEGA_CODE_WEB_SEARCH_BACKEND` as `firecrawl`, `tavily`,
+or `searxng`; use `FIRECRAWL_API_KEY`, `TAVILY_API_KEY`, or `SEARXNG_BASE_URL` as needed.
+
+## 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.7.0}/docs/src/content/docs/concepts/tools.md

@@ -38,8 +38,14 @@ the [TUI](../../cli/overview/) or [`ask`](../../cli/ask/).
 
 ### Web
 
+- `web_search` — search the web for relevant pages and return ranked results.
 - `web_fetch` — fetch and parse a web page without a full browser.
 
+Use `web_search` when you do not already know the right URL, then follow up with
+`web_fetch` to read a result in depth. The default backend is keyless DuckDuckGo;
+Firecrawl, Tavily, and self-hosted SearXNG can be selected in Settings or with
+environment variables.
+
 ### Reasoning & memory
 
 - `think_hard` — an extended-reasoning step that uses the
@@ -57,8 +63,8 @@ and `dispatch_general_agent`.
 Tools are gated by mode. In a read-only context — like [Plan mode](../../tui/modes/)
 or an investigation sub-agent — only non-mutating tools are available
 (`list_directory`, `read_entire_file`, `read_file_section`, `search_codebase`,
-`find_files_by_pattern`, `web_fetch`, `think_hard`, and reading memory). Editing
-files and running commands require Build mode's full toolset.
+`find_files_by_pattern`, `web_search`, `web_fetch`, `think_hard`, and reading
+memory). Editing files and running commands require Build mode's full toolset.
 
 This separation is what makes Plan mode safe to run against any codebase: the
 planning agent can look but not touch.

{kolega_code-0.5.1 → kolega_code-0.7.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 |
@@ -74,6 +87,18 @@ See [Providers & Models](../providers-and-models/) for what each role does.
 | `KOLEGA_CODE_STATE_DIR` | Override where settings and sessions are stored |
 | `KOLEGA_CODE_ENVIRONMENT` | Environment label attached to tracing/metadata (default `development`) |
 
+## Web search
+
+The `web_search` tool defaults to the keyless DuckDuckGo backend. Set a backend
+explicitly when you want a cloud provider or a self-hosted SearXNG instance.
+
+| Variable | Purpose |
+| --- | --- |
+| `KOLEGA_CODE_WEB_SEARCH_BACKEND` | Backend for `web_search`: `duckduckgo`, `firecrawl`, `tavily`, or `searxng` |
+| `FIRECRAWL_API_KEY` | Optional Firecrawl key for higher rate limits |
+| `TAVILY_API_KEY` | Tavily API key |
+| `SEARXNG_BASE_URL` | Base URL for a self-hosted SearXNG instance |
+
 ## Telemetry (Langfuse)
 
 Optional [Langfuse](https://langfuse.com/) tracing of LLM usage.
@@ -100,6 +125,9 @@ KOLEGA_CODE_PROVIDER=moonshot
 KOLEGA_CODE_MODEL=kimi-k2.7-code
 KOLEGA_CODE_THINKING_EFFORT=auto
 
+# Optional: web search
+KOLEGA_CODE_WEB_SEARCH_BACKEND=duckduckgo
+
 # Optional: Langfuse tracing
 LANGFUSE_HOST=https://us.cloud.langfuse.com
 LANGFUSE_PUBLIC_KEY=

{kolega_code-0.5.1 → kolega_code-0.7.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.7.0}/docs/src/content/docs/configuration/settings-and-api-keys.mdx

@@ -21,12 +21,24 @@ 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).
+
+The **Web Search** section configures the `web_search` tool. DuckDuckGo is the
+default and needs no key. Firecrawl can also run without a key, with an optional
+key for higher rate limits. Tavily requires a key, and SearXNG requires the base
+URL of your self-hosted instance. The same settings can be supplied with
+[`KOLEGA_CODE_WEB_SEARCH_BACKEND`, `FIRECRAWL_API_KEY`, `TAVILY_API_KEY`, and
+`SEARXNG_BASE_URL`](../environment-variables/#web-search).
+
 ## Where settings live
 
 Settings are stored as JSON in your platform's state directory, in a file named
@@ -45,16 +57,33 @@ 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-...",
+    "tavily": "tvly-..."
+  },
+  "agent_models": {
+    "investigation": {
+      "provider": "deepseek",
+      "model": "deepseek-v4-flash",
+      "thinking_effort": "high"
+    }
+  },
+  "web_search_backend": "tavily",
+  "web_search_base_url": null
 }
 ```
 
+`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.
+Cloud web-search keys are stored in `api_keys` under their backend names
+(`firecrawl` or `tavily`); `web_search_base_url` is used by SearXNG.
+
 <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
@@ -66,7 +95,7 @@ store keys on disk at all, supply them via
 
 <FileTree>
 - kolega-code/
-  - settings.json   Provider, model, thinking effort, and API keys (0600)
+  - settings.json   Provider, model, web search, thinking effort, and API keys (0600)
   - sessions/
     - &lt;session-id&gt;.json   One file per saved session
 </FileTree>

{kolega_code-0.5.1 → kolega_code-0.7.0}/docs/src/content/docs/index.mdx

@@ -19,8 +19,9 @@ and your sessions, settings, and API keys are stored on your own machine.
   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.
+- **Searches and browses the web.** The agent can search for relevant pages,
+  fetch URLs directly, or use the built-in browser agent (powered by Playwright)
+  when a task needs site interaction.
 - **Dispatches sub-agents.** For larger tasks, the main agent can hand off to
   specialized agents (investigation, browser, coding, general) and track their
   activity live.

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

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

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

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