kolega-code 0.1.0__tar.gz

kolega_code-0.1.0/.env.example

@@ -0,0 +1,14 @@
+# Local test credentials. Copy this file to `.env` and fill only the keys you need.
+# `.env` is ignored by git; do not commit real secrets.
+
+ANTHROPIC_API_KEY=
+OPENAI_API_KEY=
+GOOGLE_API_KEY=
+MOONSHOT_API_KEY=
+DEEPSEEK_API_KEY=
+
+BROWSERLESS_API_KEY=
+
+LANGFUSE_HOST=https://us.cloud.langfuse.com
+LANGFUSE_PUBLIC_KEY=
+LANGFUSE_SECRET_KEY=

kolega_code-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,59 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+# Allow this workflow to publish to GitHub Pages.
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment; don't cancel an in-progress production deploy.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: docs
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: docs/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build site
+        run: npm run build
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

kolega_code-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,87 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and test package
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]" build twine
+
+      - name: Verify tag matches package version
+        run: |
+          python - <<'PY'
+          import os
+          import sys
+          import tomllib
+
+          tag = os.environ["GITHUB_REF_NAME"]
+          with open("pyproject.toml", "rb") as fh:
+              version = tomllib.load(fh)["project"]["version"]
+          expected = f"v{version}"
+          if tag != expected:
+              print(f"Release tag {tag!r} does not match pyproject.toml version {version!r}; expected {expected!r}.")
+              sys.exit(1)
+          PY
+
+      - name: Run tests
+        run: python -m pytest -ra --durations=50 --import-mode=importlib -m "not slow"
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Check distributions
+        run: python -m twine check dist/*
+
+      - name: Smoke-test wheel
+        run: |
+          python -m venv /tmp/kolega-code-smoke
+          /tmp/kolega-code-smoke/bin/python -m pip install --upgrade pip
+          /tmp/kolega-code-smoke/bin/python -m pip install dist/*.whl
+          /tmp/kolega-code-smoke/bin/kolega-code --version
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/kolega-code
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-distributions
+          path: dist/
+
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

kolega_code-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.venv/
+.env
+.env.*
+!.env.example
+dist/
+build/
+*.egg-info/

kolega_code-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,73 @@
+# Contributing
+
+## Local Setup
+
+Kolega Code requires Python 3.11 or newer.
+
+Install the CLI and development dependencies with `uv`:
+
+```bash
+uv sync --extra cli --extra dev
+```
+
+If you prefer `pip`, install the package in editable mode:
+
+```bash
+pip install -e ".[cli,dev]"
+```
+
+Run the CLI locally:
+
+```bash
+kolega-code .
+```
+
+Some slow and integration tests require provider credentials. Copy the example
+environment file only when you need those tests, and never commit real secrets:
+
+```bash
+cp .env.example .env
+```
+
+## Tests
+
+Run the fast test suite before opening a pull request:
+
+```bash
+./run_tests.sh
+```
+
+Run slow and integration tests only when you have the required credentials:
+
+```bash
+./run_tests.sh --all
+```
+
+You can pass additional pytest arguments through the wrapper:
+
+```bash
+./run_tests.sh kolega_code/agent/tests/llm/test_client.py -ra
+```
+
+## Documentation
+
+The documentation site lives in `docs/`.
+
+```bash
+cd docs
+npm ci
+npm run build
+```
+
+Use `npm run dev` from `docs/` for local documentation development.
+
+## Pull Requests
+
+- Keep changes focused and avoid unrelated refactors.
+- Add or update tests for behavior changes.
+- Update documentation when user-facing behavior changes.
+- Do not commit `.env`, local settings, credentials, API keys, tokens, or private
+  endpoints.
+- Use obviously fake credential placeholders in tests and docs, not strings that
+  match real token formats.
+- Report security issues privately according to `SECURITY.md`.

kolega_code-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+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.

kolega_code-0.1.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: kolega-code
+Version: 0.1.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: browser-use==0.1.40
+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: 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
+
+Kolega Code is a local-first AI coding agent for the terminal.
+
+The package owns the `kolega_code` import namespace and provides the
+`kolega-code` command.
+
+## Install
+
+Install with the public installer:
+
+```bash
+curl -fsSL https://kolega.dev/install-kolega-code | sh
+```
+
+Or install directly from PyPI with uv:
+
+```bash
+uv tool install kolega-code
+```
+
+Verify the command is available:
+
+```bash
+kolega-code --version
+```
+
+Upgrade or uninstall:
+
+```bash
+uv tool upgrade kolega-code
+uv tool uninstall kolega-code
+```
+
+Run the Textual UI and open the Settings tab to select Moonshot Kimi K2.6 or DeepSeek V4 Pro and save your API key:
+
+```bash
+kolega-code .
+```
+
+In the Textual UI, press `Shift+Tab` to switch between build mode and planning mode. Planning mode uses a standalone read-only planning agent; when it submits a complete plan, choose whether to implement it or keep discussing the plan.
+
+All CLI sessions use the CLI-specific coding-agent prompt, including resumed sessions. Launching the UI starts a fresh thread by default. Resume an existing thread explicitly:
+
+```bash
+kolega-code . --resume
+kolega-code . --resume <thread-or-session-id>
+```
+
+You can also set `MOONSHOT_API_KEY`, `DEEPSEEK_API_KEY`, or keep using env/flag based configuration for non-UI commands:
+
+```bash
+kolega-code ask "summarize this repository" --project .
+kolega-code ask "summarize this repository" --project . --provider deepseek --model deepseek-v4-pro
+kolega-code sessions list --project .
+kolega-code doctor --project .
+```
+
+The Settings UI supports Moonshot `kimi-k2.6` and DeepSeek `deepseek-v4-pro`. A saved UI selection is used for all agent model roles and API keys are stored in the local CLI settings file with restrictive permissions. Existing environment and model/provider flag overrides continue to work. Local session state is stored under the platform state directory unless `KOLEGA_CODE_STATE_DIR` is set.
+
+## From source
+
+```bash
+git clone https://github.com/kolega-ai/kolega-code.git
+cd kolega-code
+uv sync --extra dev
+uv run kolega-code --version
+```
+
+## Tests
+
+Fast tests run by default:
+
+```bash
+./run_tests.sh
+```
+
+Some slow and integration tests require real provider credentials. To run them locally, create an ignored `.env` file from the example and fill only the keys you need:
+
+```bash
+cp .env.example .env
+./run_tests.sh --all
+```
+
+The test runner loads `.env` through pytest and keeps existing shell environment variables higher priority than values in the file. You can pass additional pytest arguments through the wrapper:
+
+```bash
+./run_tests.sh kolega_code/agent/tests/llm/test_client.py -ra
+```

kolega_code-0.1.0/README.md

@@ -0,0 +1,89 @@
+# kolega-code
+
+Kolega Code is a local-first AI coding agent for the terminal.
+
+The package owns the `kolega_code` import namespace and provides the
+`kolega-code` command.
+
+## Install
+
+Install with the public installer:
+
+```bash
+curl -fsSL https://kolega.dev/install-kolega-code | sh
+```
+
+Or install directly from PyPI with uv:
+
+```bash
+uv tool install kolega-code
+```
+
+Verify the command is available:
+
+```bash
+kolega-code --version
+```
+
+Upgrade or uninstall:
+
+```bash
+uv tool upgrade kolega-code
+uv tool uninstall kolega-code
+```
+
+Run the Textual UI and open the Settings tab to select Moonshot Kimi K2.6 or DeepSeek V4 Pro and save your API key:
+
+```bash
+kolega-code .
+```
+
+In the Textual UI, press `Shift+Tab` to switch between build mode and planning mode. Planning mode uses a standalone read-only planning agent; when it submits a complete plan, choose whether to implement it or keep discussing the plan.
+
+All CLI sessions use the CLI-specific coding-agent prompt, including resumed sessions. Launching the UI starts a fresh thread by default. Resume an existing thread explicitly:
+
+```bash
+kolega-code . --resume
+kolega-code . --resume <thread-or-session-id>
+```
+
+You can also set `MOONSHOT_API_KEY`, `DEEPSEEK_API_KEY`, or keep using env/flag based configuration for non-UI commands:
+
+```bash
+kolega-code ask "summarize this repository" --project .
+kolega-code ask "summarize this repository" --project . --provider deepseek --model deepseek-v4-pro
+kolega-code sessions list --project .
+kolega-code doctor --project .
+```
+
+The Settings UI supports Moonshot `kimi-k2.6` and DeepSeek `deepseek-v4-pro`. A saved UI selection is used for all agent model roles and API keys are stored in the local CLI settings file with restrictive permissions. Existing environment and model/provider flag overrides continue to work. Local session state is stored under the platform state directory unless `KOLEGA_CODE_STATE_DIR` is set.
+
+## From source
+
+```bash
+git clone https://github.com/kolega-ai/kolega-code.git
+cd kolega-code
+uv sync --extra dev
+uv run kolega-code --version
+```
+
+## Tests
+
+Fast tests run by default:
+
+```bash
+./run_tests.sh
+```
+
+Some slow and integration tests require real provider credentials. To run them locally, create an ignored `.env` file from the example and fill only the keys you need:
+
+```bash
+cp .env.example .env
+./run_tests.sh --all
+```
+
+The test runner loads `.env` through pytest and keeps existing shell environment variables higher priority than values in the file. You can pass additional pytest arguments through the wrapper:
+
+```bash
+./run_tests.sh kolega_code/agent/tests/llm/test_client.py -ra
+```

kolega_code-0.1.0/RELEASING.md

@@ -0,0 +1,76 @@
+# Releasing Kolega Code
+
+This project publishes the `kolega-code` package to PyPI and serves the public
+installer from `https://kolega.dev/install-kolega-code`.
+
+## First PyPI release
+
+The first release can be published from the existing maintainer PyPI user
+account, then transferred to the Kolega PyPI organization after PyPI approves
+the organization request.
+
+1. In PyPI, create a pending Trusted Publisher under the maintainer user account.
+
+   Use these values:
+
+   - PyPI project name: `kolega-code`
+   - GitHub owner: `kolega-ai`
+   - GitHub repository: `kolega-code`
+   - Workflow filename: `release.yml`
+   - Environment name: `pypi`
+
+2. In GitHub, create an environment named `pypi`.
+
+   Require approval from trusted maintainers before deployment. The release
+   workflow will pause before publishing to PyPI.
+
+3. Confirm `pyproject.toml` has the release version.
+
+4. Create and push a matching tag:
+
+   ```bash
+   git tag v0.1.0
+   git push origin v0.1.0
+   ```
+
+5. Approve the `pypi` environment deployment in GitHub Actions.
+
+6. Verify the release:
+
+   ```bash
+   uv tool install --force kolega-code
+   kolega-code --version
+   ```
+
+## Installer handoff
+
+The canonical installer source is tracked at:
+
+```text
+scripts/install-kolega-code
+```
+
+The `kolega.dev` site repo should publish that file verbatim at:
+
+```text
+https://kolega.dev/install-kolega-code
+```
+
+After updating the site, verify:
+
+```bash
+curl -fsSL https://kolega.dev/install-kolega-code | sh
+```
+
+## Transfer to the PyPI organization
+
+After the Kolega PyPI organization is approved:
+
+1. Open the PyPI organization page.
+2. Go to **Projects**.
+3. Transfer the existing `kolega-code` project from the maintainer user account.
+4. Confirm maintainers and teams have the expected permissions.
+5. Re-check the `kolega-code` project **Publishing** page and confirm the
+   Trusted Publisher still points at `kolega-ai/kolega-code` and `release.yml`.
+
+The package name and install commands stay the same after transfer.

kolega_code-0.1.0/SECURITY.md

@@ -0,0 +1,29 @@
+# Security Policy
+
+## Supported Versions
+
+Kolega Code is currently pre-1.0. Security reports are accepted for the latest
+`main` branch and the latest published release. Older prerelease versions are
+supported only when the issue is still reproducible on `main`.
+
+## Reporting a Vulnerability
+
+Do not open public GitHub issues for suspected vulnerabilities.
+
+Use GitHub private vulnerability reporting from the repository's Security tab.
+If that is unavailable, contact a maintainer privately and ask for a secure
+reporting channel before sharing exploit details.
+
+Please include:
+
+- The affected version, commit, or branch.
+- The expected and observed behavior.
+- Steps to reproduce the issue.
+- Any proof of concept, logs, or stack traces.
+- The impact you believe the issue has.
+
+## Disclosure
+
+Maintainers will triage reports privately and coordinate disclosure after a fix
+or mitigation is available. Please do not publish details until the maintainers
+have had a reasonable opportunity to investigate and respond.

kolega_code-0.1.0/conftest.py

@@ -0,0 +1,34 @@
+"""Shared pytest configuration for the repository."""
+
+from pathlib import Path
+
+import pytest
+from dotenv import load_dotenv
+
+from kolega_code.cli.config import API_KEY_ENV
+
+
+CLI_CONFIG_ENV_KEYS = {
+    "KOLEGA_CODE_PROVIDER",
+    "KOLEGA_CODE_MODEL",
+    "KOLEGA_CODE_FAST_PROVIDER",
+    "KOLEGA_CODE_FAST_MODEL",
+    "KOLEGA_CODE_EDIT_PROVIDER",
+    "KOLEGA_CODE_EDIT_MODEL",
+    "KOLEGA_CODE_THINKING_PROVIDER",
+    "KOLEGA_CODE_THINKING_MODEL",
+    "KOLEGA_CODE_THINKING_TOKENS",
+    "KOLEGA_CODE_ENVIRONMENT",
+}
+
+
+def pytest_configure() -> None:
+    """Load local test environment variables before test modules import."""
+    load_dotenv(Path(__file__).with_name(".env"), override=False)
+
+
+@pytest.fixture
+def isolated_cli_env(monkeypatch: pytest.MonkeyPatch) -> None:
+    """Remove process CLI config so unit tests don't depend on a developer .env."""
+    for key in {*API_KEY_ENV.values(), *CLI_CONFIG_ENV_KEYS}:
+        monkeypatch.delenv(key, raising=False)

kolega_code-0.1.0/docs/.gitignore

@@ -0,0 +1,21 @@
+# build output
+dist/
+
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store