kolega-code 0.8.4__tar.gz → 0.10.0__tar.gz

kolega_code-0.10.0/.env.example

@@ -0,0 +1,31 @@
+# Developer/test credentials for this repository.
+#
+# Installed Kolega Code does NOT automatically load a target project's `.env`
+# for its own provider/model configuration. For normal CLI use, save keys in the
+# Settings tab or export environment variables in the shell that launches
+# `kolega-code`.
+#
+# This sample exists for repository-local development and live integration tests.
+# Copy it to `.env` only in this repo, fill only the keys you need, and never
+# commit real secrets.
+
+ANTHROPIC_API_KEY=
+OPENAI_API_KEY=
+# Prefer a ChatGPT subscription over an OpenAI API key? Run `/login` in the TUI
+# (no key needed). Optional override of the OAuth client id, for testing only:
+# KOLEGA_CODE_CHATGPT_CLIENT_ID=
+GOOGLE_API_KEY=
+FIREWORKS_API_KEY=
+MOONSHOT_API_KEY=
+DEEPSEEK_API_KEY=
+ZAI_API_KEY=
+KIMI_CODING_API_KEY=
+OLLAMA_API_KEY=
+
+KOLEGA_CODE_THINKING_EFFORT=
+
+BROWSERLESS_API_KEY=
+
+LANGFUSE_HOST=https://us.cloud.langfuse.com
+LANGFUSE_PUBLIC_KEY=
+LANGFUSE_SECRET_KEY=

kolega_code-0.10.0/.github/workflows/ci.yml

@@ -0,0 +1,204 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  changes:
+    name: Detect changed files
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      coverage-badge-only: ${{ steps.detect.outputs.coverage-badge-only }}
+    steps:
+      - name: Detect coverage-badge-only change
+        id: detect
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          if [ "${{ github.event_name }}" = "pull_request" ]; then
+            files=$(gh api "repos/${{ github.repository }}/pulls/${{ github.event.pull_request.number }}/files" --paginate --jq '.[].filename')
+          elif [ "${{ github.event_name }}" = "push" ]; then
+            files=$(gh api "repos/${{ github.repository }}/compare/${{ github.event.before }}...${{ github.sha }}" --jq '.files[].filename')
+          else
+            echo "coverage-badge-only=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          echo "Changed files:"
+          echo "$files"
+
+          file_count=$(printf '%s\n' "$files" | sed '/^$/d' | wc -l | tr -d ' ')
+          if [ "$file_count" = "1" ] && [ "$files" = "docs/src/assets/coverage.svg" ]; then
+            echo "coverage-badge-only=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "coverage-badge-only=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  tests:
+    name: Python ${{ matrix.python-version }}
+    needs: changes
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - name: Skip coverage-badge-only change
+        if: needs.changes.outputs.coverage-badge-only == 'true'
+        run: echo "Skipping Python checks for coverage badge-only change."
+
+      - name: Checkout
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        uses: actions/checkout@v5
+
+      - name: Setup Python
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Setup uv
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        run: uv sync --extra dev --frozen
+
+      - name: Run pre-commit hooks
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        run: uv run pre-commit run --all-files --show-diff-on-failure
+
+      - name: Run fast tests with coverage
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        run: ./run_tests.sh --coverage
+
+      - name: Upload coverage report
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        uses: actions/upload-artifact@v6
+        with:
+          name: coverage-xml-python-${{ matrix.python-version }}
+          path: coverage.xml
+          if-no-files-found: error
+
+  coverage-badge:
+    name: Update coverage badge
+    needs: [changes, tests]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main' && needs.changes.outputs.coverage-badge-only != 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        run: uv sync --extra dev --frozen
+
+      - name: Download Python 3.11 coverage report
+        uses: actions/download-artifact@v8
+        with:
+          name: coverage-xml-python-3.11
+          path: coverage-artifact
+
+      - name: Generate coverage badge
+        run: |
+          uv run genbadge coverage -i coverage-artifact/coverage.xml -o docs/src/assets/coverage.svg
+          python - <<'PY'
+          from pathlib import Path
+
+          badge = Path("docs/src/assets/coverage.svg")
+          badge.write_text(badge.read_text().rstrip("\n") + "\n")
+          PY
+
+      - name: Verify coverage badge PR token
+        env:
+          COVERAGE_BADGE_PR_TOKEN: ${{ secrets.COVERAGE_BADGE_PR_TOKEN }}
+        run: |
+          if [ -z "$COVERAGE_BADGE_PR_TOKEN" ]; then
+            echo "::error::Set the COVERAGE_BADGE_PR_TOKEN repository secret to a trusted bot/user token."
+            exit 1
+          fi
+
+      - name: Create coverage badge pull request
+        id: cpr
+        uses: peter-evans/create-pull-request@v8
+        with:
+          token: ${{ secrets.COVERAGE_BADGE_PR_TOKEN }}
+          add-paths: docs/src/assets/coverage.svg
+          commit-message: "chore: update coverage badge"
+          committer: "${{ vars.COVERAGE_BADGE_COMMITTER || 'github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>' }}"
+          author: "${{ vars.COVERAGE_BADGE_AUTHOR || 'github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>' }}"
+          branch: chore/update-coverage-badge
+          delete-branch: true
+          title: "chore: update coverage badge"
+          body: |
+            Automated coverage badge update from CI after tests passed on `main`.
+
+      - name: Enable auto-merge for coverage badge PR
+        if: steps.cpr.outputs.pull-request-number != '' && steps.cpr.outputs.pull-request-operation != 'none'
+        env:
+          GH_TOKEN: ${{ secrets.COVERAGE_BADGE_PR_TOKEN }}
+        run: |
+          gh pr merge "${{ steps.cpr.outputs.pull-request-number }}" --auto --squash --delete-branch
+
+  dependency-audit:
+    name: Dependency audit
+    needs: changes
+    runs-on: ubuntu-latest
+    steps:
+      - name: Skip coverage-badge-only change
+        if: needs.changes.outputs.coverage-badge-only == 'true'
+        run: echo "Skipping dependency audit for coverage badge-only change."
+
+      - name: Checkout
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        uses: actions/checkout@v5
+
+      - name: Setup Python
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Setup uv
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Audit locked dependencies
+        if: needs.changes.outputs.coverage-badge-only != 'true'
+        run: uv audit --locked

{kolega_code-0.8.4 → kolega_code-0.10.0}/.gitignore

@@ -7,7 +7,7 @@ __pycache__/
 .env
 .env.*
 !.env.example
-.kolega/permissions.json
+.kolega/
 dist/
 build/
 *.egg-info/

{kolega_code-0.8.4 → kolega_code-0.10.0}/CHANGELOG.md

@@ -6,6 +6,38 @@ This project uses GitHub Releases for detailed generated release notes. This fil
 
 ## Unreleased
 
+## 0.10.0 - 2026-06-25
+
+### Added
+
+- Added a session changes inspector to the TUI that shows git diffs for the
+  current session, renders added files as diffs, presents an empty state, and
+  hides captured edit events.
+- Added project prompt overrides, including variable rendering, override status
+  shown at startup, validation, and selective dump support.
+
+### Fixed
+
+- Preserved Ollama Cloud reasoning provider metadata.
+- Ignored project `.dotenv` files when loading model config.
+- Stabilized terminal rendering artifacts in the TUI.
+- Restored the generated root CLI help.
+- Surfaced prompt override render errors.
+
+### Changed
+
+- Split the LLM specs module into a package for maintainability.
+
+## 0.9.0 - 2026-06-24
+
+### Added
+
+- Added Ollama Cloud as a supported provider, including its model catalog and reasoning-field capture.
+
+### Fixed
+
+- Clarified the disconnected state shown on first run when no provider is configured.
+
 ## 0.8.4 - 2026-06-24
 
 ### Added

{kolega_code-0.8.4 → kolega_code-0.10.0}/CONTRIBUTING.md

@@ -101,6 +101,31 @@ npm run build
 
 Use `npm run dev` from `docs/` for local documentation development.
 
+## Maintainer automation
+
+The CI workflow updates `docs/src/assets/coverage.svg` by opening an automated pull
+request. Configure the repository secret `COVERAGE_BADGE_PR_TOKEN` with a trusted
+bot or maintainer token instead of `GITHUB_TOKEN`; GitHub requires manual approval
+before workflows run on pull requests opened by `github-actions[bot]`.
+
+Use a fine-grained personal access token or GitHub App token scoped to this
+repository with:
+
+- Contents: read and write
+- Pull requests: read and write
+- Metadata: read-only, included automatically
+
+The token owner should be a trusted repository member or bot account. Do not use
+a first-time external contributor account, and never commit the token value.
+
+Optional repository variables can customize the Git commit identity used for the
+badge update commit:
+
+- `COVERAGE_BADGE_AUTHOR`
+- `COVERAGE_BADGE_COMMITTER`
+
+Use values like `Name <email@example.com>`.
+
 ## Pull Requests
 
 - Keep changes focused and avoid unrelated refactors.

{kolega_code-0.8.4 → kolega_code-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kolega-code
-Version: 0.8.4
+Version: 0.10.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/
@@ -216,6 +216,13 @@ The `web_search` tool uses DuckDuckGo by default without a key. To choose anothe
 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.
 
+Projects can also override Kolega Code's base prompts with uppercase Markdown templates in
+`.kolega/prompts/`. Generate editable starters with Jinja replacement tags using `/prompts dump`
+in the TUI or `kolega-code prompts dump --project .` in a terminal. To dump only selected
+starters, pass prompt names such as `coder`, `planning`, or `compaction` (filename aliases
+like `CODER.md` work too). Validate existing overrides with `/prompts validate` or
+`kolega-code prompts validate --project .`.
+
 ## Requirements
 
 - **Python 3.11+**

{kolega_code-0.8.4 → kolega_code-0.10.0}/README.md

@@ -134,6 +134,13 @@ The `web_search` tool uses DuckDuckGo by default without a key. To choose anothe
 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.
 
+Projects can also override Kolega Code's base prompts with uppercase Markdown templates in
+`.kolega/prompts/`. Generate editable starters with Jinja replacement tags using `/prompts dump`
+in the TUI or `kolega-code prompts dump --project .` in a terminal. To dump only selected
+starters, pass prompt names such as `coder`, `planning`, or `compaction` (filename aliases
+like `CODER.md` work too). Validate existing overrides with `/prompts validate` or
+`kolega-code prompts validate --project .`.
+
 ## Requirements
 
 - **Python 3.11+**

{kolega_code-0.8.4 → kolega_code-0.10.0}/docs/src/assets/coverage.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="114" height="20" role="img" aria-label="coverage: 80.07%"><title>coverage: 80.07%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="114" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="53" height="20" fill="#67ac09"/><rect width="114" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="865" y="150" fill-opacity=".8" filter="url(#blur)" textLength="430">80.07%</text><text x="865" y="150" fill-opacity=".3" textLength="430">80.07%</text></g><text x="865" y="140" textLength="430">80.07%</text></g></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="114" height="20" role="img" aria-label="coverage: 80.49%"><title>coverage: 80.49%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="114" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="53" height="20" fill="#67ac09"/><rect width="114" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="865" y="150" fill-opacity=".8" filter="url(#blur)" textLength="430">80.49%</text><text x="865" y="150" fill-opacity=".3" textLength="430">80.49%</text></g><text x="865" y="140" textLength="430">80.49%</text></g></g></svg>

{kolega_code-0.8.4 → kolega_code-0.10.0}/docs/src/content/docs/configuration/environment-variables.md

@@ -3,25 +3,29 @@ title: Environment Variables
 description: Every environment variable Kolega Code reads, and how precedence works.
 ---
 
-Kolega Code reads configuration from environment variables and from a project-local
-`.env` file. This page lists everything it understands.
+Kolega Code reads configuration from CLI flags, exported environment variables,
+and saved Settings. It does **not** automatically load the target project's
+`.env` file for its own provider/model/API-key configuration. This page lists the
+environment variables it understands when they are explicitly present in the
+Kolega Code process environment.
 
 ## Precedence
 
 For any given setting, the first available source wins:
 
 1. **CLI flags** (e.g. `--provider`, `--model`)
-2. **Shell environment variables**
-3. **Project `.env` file** (in the project directory)
-4. **Saved Settings** (`settings.json`)
+2. **Exported process environment variables**
+3. **Saved Settings** (`settings.json`)
 
-Kolega Code requires an explicit provider/model selection from flags,
-environment variables, a project `.env` file, or saved settings. API key
-variables alone are not a model selection source.
+Kolega Code requires an explicit provider/model selection from flags, exported
+environment variables, or saved settings. API key variables alone are not a model
+selection source.
 
 :::note
-Within the env layer, your **shell environment takes priority over the `.env`
-file** — values exported in your shell override the same key in `.env`.
+A project `.env` file is treated as part of the project being edited. Kolega Code
+will not read it for its own LLM configuration. For persistent credentials, use
+Settings. For automation, export environment variables in the shell or CI process
+that launches Kolega Code.
 :::
 
 ## API keys
@@ -46,12 +50,14 @@ provider or model.
 | `DEEPSEEK_API_KEY` | DeepSeek |
 | `ZAI_API_KEY` | Z.AI (GLM Coding Plan) |
 | `KIMI_CODING_API_KEY` | Kimi Coding Plan |
+| `OLLAMA_API_KEY` | Ollama Cloud |
 
 The local `llama` provider needs no key. The `zai` key authenticates against Z.AI's
 Anthropic-compatible endpoint (it is the key Z.AI also documents as `ANTHROPIC_AUTH_TOKEN`).
 The `kimi_coding` key authenticates against the Kimi Coding Plan's separate
 Anthropic-compatible endpoint (`https://api.kimi.com/coding/`), which is distinct from the
 standard Moonshot API used by the `moonshot` provider.
+The `OLLAMA_API_KEY` key authenticates against Ollama Cloud's direct API (`https://ollama.com/v1` for OpenAI-compatible requests).
 
 ## Model selection
 
@@ -109,37 +115,26 @@ Optional [Langfuse](https://langfuse.com/) tracing of LLM usage.
 | `LANGFUSE_PUBLIC_KEY` | Langfuse public key |
 | `LANGFUSE_SECRET_KEY` | Langfuse secret key |
 
-## Using a `.env` file
+## About project `.env` files
 
-Kolega Code automatically loads a `.env` file from the project directory. A good
-starting point:
+Kolega Code does not automatically load a `.env` file from the project directory.
+That file commonly belongs to the app being edited, so consuming it as Kolega
+Code configuration can accidentally pick up unrelated application secrets such as
+`OPENAI_API_KEY`.
 
-```bash title=".env"
-# Pick one provider's key (or several)
-MOONSHOT_API_KEY=
-DEEPSEEK_API_KEY=
-FIREWORKS_API_KEY=
-ANTHROPIC_API_KEY=
+Use one of these instead:
 
-# Optional: choose models per role
-KOLEGA_CODE_PROVIDER=moonshot
-KOLEGA_CODE_MODEL=kimi-k2.7-code
-KOLEGA_CODE_THINKING_EFFORT=auto
-
-# Fireworks example:
-# KOLEGA_CODE_PROVIDER=fireworks
-# KOLEGA_CODE_MODEL=accounts/fireworks/models/glm-5p2
-
-# Optional: web search
-KOLEGA_CODE_WEB_SEARCH_BACKEND=duckduckgo
-
-# Optional: Langfuse tracing
-LANGFUSE_HOST=https://us.cloud.langfuse.com
-LANGFUSE_PUBLIC_KEY=
-LANGFUSE_SECRET_KEY=
+```bash title="one-off shell configuration"
+export MOONSHOT_API_KEY=...
+export KOLEGA_CODE_PROVIDER=moonshot
+export KOLEGA_CODE_MODEL=kimi-k2.7-code
+kolega-code
 ```
 
+Or save the provider, model, and API key in the TUI Settings tab. Settings are
+the recommended persistent configuration path for interactive use.
+
 :::caution
-Keep `.env` out of version control — it holds secrets. Add it to your
-`.gitignore`.
+Keep project `.env` files out of version control — they often hold application
+secrets. Add them to your `.gitignore`.
 :::

kolega_code-0.10.0/docs/src/content/docs/configuration/prompt-overrides.md

@@ -0,0 +1,145 @@
+---
+title: Prompt overrides
+---
+
+Kolega Code can load repository-local Markdown templates that replace its base system prompts. This is useful when a project needs a different operating style, stricter rules, or specialized instructions for sub-agents.
+
+## File layout
+
+Create uppercase Markdown files under `.kolega/prompts/`:
+
+```text
+.kolega/prompts/
+  CODER.md          # CoderAgent, all coder modes
+  PLANNING.md       # PlanningAgent
+  GENERAL.md        # GeneralAgent sub-agent
+  INVESTIGATION.md  # InvestigationAgent sub-agent
+  BROWSER.md        # BrowserAgent sub-agent
+  COMPACTION.md     # conversation compaction summarizer
+```
+
+Only these uppercase filenames are recognized. Lowercase aliases such as `coder.md` are ignored. Every file is optional: you can override only `CODER.md`, only `COMPACTION.md`, or any subset. Missing files fall back to Kolega Code's bundled or host-provided defaults.
+
+`CODER.md` is the only coder override. It applies to the coder agent in every coder mode, even though Kolega Code internally has separate hosted prompt template slots for `cli`, `code`, `vibe`, and `fix`.
+
+## Generate starter files
+
+In the TUI, run:
+
+```text
+/prompts dump
+```
+
+From a terminal, run:
+
+```bash
+kolega-code prompts dump --project .
+```
+
+Both commands create any missing files in `.kolega/prompts/` from Kolega Code's current bundled/base prompts. Existing files are skipped by default so local edits are not overwritten.
+
+To dump only specific starter files, pass one or more prompt selectors:
+
+```text
+/prompts dump coder compaction
+```
+
+```bash
+kolega-code prompts dump coder compaction --project .
+```
+
+Supported selectors are `coder`, `planning`, `general`, `investigation`, `browser`, `compaction`, and `all`. Filename aliases are also accepted case-insensitively, so `CODER.md`, `coder.md`, and `CODER` all select the coder prompt.
+
+To overwrite existing files:
+
+```text
+/prompts dump --force
+```
+
+```bash
+kolega-code prompts dump --project . --force
+```
+
+`--force` also works with selective dumps:
+
+```bash
+kolega-code prompts dump compaction --project . --force
+```
+
+To see which overrides exist:
+
+```text
+/prompts list
+```
+
+```bash
+kolega-code prompts list --project .
+```
+
+To validate existing overrides before restarting or sharing a repository:
+
+```text
+/prompts validate
+```
+
+```bash
+kolega-code prompts validate --project .
+```
+
+Validation uses the same strict Jinja rendering check that runs during startup. Missing optional files are not errors. The terminal command exits `0` when all existing supported overrides are valid (or no overrides exist), and exits `1` when any override cannot render.
+
+Dumped files are editable Markdown templates. Environment values are written as Jinja tags, not frozen current values. For example:
+
+```md
+- Working directory: {{ context.project_path }}
+- Is directory a git repo: {{ context.is_git_repo }}
+- Platform: {{ context.platform }}
+- Today's date: {{ context.date_today }}
+- Model: {{ context.model_name }}
+```
+
+## Template variables
+
+Override files are rendered with a limited Jinja variable context. These variables are available:
+
+- `context.system_name`
+- `context.project_path`
+- `context.is_git_repo`
+- `context.platform`
+- `context.date_today`
+- `context.model_name`
+- `context.available_ports`
+- `context.workspace_id`
+- `context.workspace_environment_variables`
+- `mode`
+- `project_template_slug`
+
+Common fields are also available as top-level aliases:
+
+- `system_name`
+- `project_path`
+- `is_git_repo`
+- `platform`
+- `date_today`
+- `model_name`
+- `available_ports`
+- `workspace_id`
+
+Project override templates can use variables, conditionals, and loops over the exposed values. Project-local `{% include %}` and `{% import %}` are not supported.
+
+## How overrides are applied
+
+Agent prompt overrides replace the bundled base system prompt for that agent type. Kolega Code still appends dynamic runtime/project sections after your override, including:
+
+- matching prompt extensions, such as skills or gigacode guidance
+- workspace memories
+- `AGENTS.md` or legacy `KOLEGA.md` project guidance
+- `AGENT_MEMORY.md`
+
+`COMPACTION.md` is different: it fully replaces only the system prompt used by the conversation compaction summarizer. The user prompt containing the conversation history is still generated by Kolega Code.
+
+Each override file is capped at 128 KiB. If a file is unreadable, too large, or cannot be rendered, Kolega Code logs a warning and falls back to the normal bundled/host prompt.
+
+## Security note
+
+Prompt overrides let a repository influence agent behavior. Review `.kolega/prompts/` in untrusted projects just as you would review `AGENTS.md`, scripts, hooks, or other project-local automation.

{kolega_code-0.8.4 → kolega_code-0.10.0}/docs/src/content/docs/configuration/providers-and-models.mdx

@@ -27,6 +27,7 @@ The agent runtime recognizes these providers:
 | DeepSeek | `deepseek` | `DEEPSEEK_API_KEY` |
 | Z.AI (GLM Coding Plan) | `zai` | `ZAI_API_KEY` |
 | Kimi Coding Plan | `kimi_coding` | `KIMI_CODING_API_KEY` |
+| Ollama Cloud | `ollama_cloud` | `OLLAMA_API_KEY` |
 | Llama (local) | `llama` | _none — local model_ |
 
 <Aside type="tip">
@@ -45,6 +46,15 @@ with thinking effort `auto` (enabled) requests route to **K2.7 Code**, and with
 (disabled) they route to **K2.6**. Set `KIMI_CODING_API_KEY` to your Kimi Coding Plan key.
 </Aside>
 
+<Aside type="tip">
+**Ollama Cloud.** The `ollama_cloud` provider uses Ollama Cloud's direct
+OpenAI-compatible API at `https://ollama.com/v1` with `OLLAMA_API_KEY`. Kolega
+Code uses the direct API model IDs returned by Ollama, such as **`glm-5.2`** and
+**`gpt-oss:120b`**, rather than local Ollama aliases such as `:cloud` or
+`-cloud`. Ollama may deprecate or retire older cloud models, so the supported
+model catalog should be refreshed periodically from Ollama's model library/API.
+</Aside>
+
 <Aside type="tip">
 **Fireworks.ai.** The `fireworks` provider targets Fireworks' OpenAI-compatible
 serverless endpoint (`https://api.fireworks.ai/inference/v1`) with `FIREWORKS_API_KEY`.
@@ -164,6 +174,8 @@ models in the TUI.
 | Z.AI `glm-5.2` | `high`, `max` | `max` |
 | Z.AI `glm-5.1` | `auto`, `none` | `auto` |
 | Fireworks serverless reasoning models | `none`, `low`, `medium`, `high`, `max` | `medium` |
+| Ollama Cloud thinking models | `none`, `low`, `medium`, `high`, `max` | `medium` |
+| Ollama Cloud `gpt-oss:*` | `low`, `medium`, `high` | `medium` |
 | Google `gemini-2.5-pro` | `auto`, `low`, `medium`, `high` | `medium` |
 | OpenAI reasoning models | `low`, `medium`, `high` | `medium` |
 

{kolega_code-0.8.4 → kolega_code-0.10.0}/kolega_code/__init__.py

@@ -151,4 +151,4 @@ __all__ = [
     "parse_git_status_output",
 ]
 
-__version__ = "0.8.4"
+__version__ = "0.10.0"

{kolega_code-0.8.4 → kolega_code-0.10.0}/kolega_code/agent/__init__.py

@@ -44,4 +44,4 @@ __all__ = [
     "ToolExtension",
 ]
 
-__version__ = "0.8.4"
+__version__ = "0.10.0"