kon-coding-agent 0.4.0__tar.gz → 0.4.1__tar.gz

{kon_coding_agent-0.4.0 → kon_coding_agent-0.4.1}/.agents/skills/kon-tmux-test/SKILL.md

@@ -29,14 +29,14 @@ Kon is a TUI (Textual-based) app. Running tests programmatically is hard. Tmux p
 
 ```bash
 # Run all e2e tests from the repo root
-bash .kon/skills/kon-tmux-test/run-e2e-tests.sh
+bash .agents/skills/kon-tmux-test/run-e2e-tests.sh
 
 # Optional: keep the temporary HOME for debugging
-KEEP_E2E_HOME=1 bash .kon/skills/kon-tmux-test/run-e2e-tests.sh
+KEEP_E2E_HOME=1 bash .agents/skills/kon-tmux-test/run-e2e-tests.sh
 
 # Optional: override launch command/provider/model
 KON_CMD='uv run kon --model gpt-5.5' \
-  bash .kon/skills/kon-tmux-test/run-e2e-tests.sh
+  bash .agents/skills/kon-tmux-test/run-e2e-tests.sh
 ```
 
 After running, read `/tmp/kon-test-*.txt` and evaluate the captured pane/config/filesystem outputs.
@@ -48,7 +48,7 @@ After running, read `/tmp/kon-test-*.txt` and evaluate the captured pane/config/
 Creates a deterministic test project structure at `/tmp/kon-test-project/`.
 
 ```bash
-bash .kon/skills/kon-tmux-test/setup-test-project.sh
+bash .agents/skills/kon-tmux-test/setup-test-project.sh
 ```
 
 ### Main Test Script: `run-e2e-tests.sh`
@@ -56,7 +56,7 @@ bash .kon/skills/kon-tmux-test/setup-test-project.sh
 Runs comprehensive e2e tests including UI triggers, runtime controls, tab completion, and tool execution.
 
 ```bash
-bash .kon/skills/kon-tmux-test/run-e2e-tests.sh
+bash .agents/skills/kon-tmux-test/run-e2e-tests.sh
 ```
 
 ## Test Categories

{kon_coding_agent-0.4.0 → kon_coding_agent-0.4.1}/.agents/skills/kon-tmux-test/run-e2e-tests.sh

@@ -29,8 +29,8 @@ capture() {
 }
 
 capture_config() {
-    if [ -f "$TEST_HOME/.kon/config.toml" ]; then
-        cp "$TEST_HOME/.kon/config.toml" "$1"
+    if [ -f "$TEST_HOME/.config/kon/config.toml" ]; then
+        cp "$TEST_HOME/.config/kon/config.toml" "$1"
     else
         echo "CONFIG_NOT_FOUND" > "$1"
     fi
@@ -74,12 +74,12 @@ trap cleanup EXIT
 echo "Setting up isolated e2e environment..."
 cleanup
 rm -rf "$TEST_DIR" "$TEST_HOME"
-mkdir -p "$TEST_DIR" "$TEST_HOME/.kon"
-if [ -f "$HOME/.kon/openai_auth.json" ]; then
-    cp "$HOME/.kon/openai_auth.json" "$TEST_HOME/.kon/openai_auth.json"
+mkdir -p "$TEST_DIR" "$TEST_HOME/.config/kon"
+if [ -f "$HOME/.config/kon/openai_auth.json" ]; then
+    cp "$HOME/.config/kon/openai_auth.json" "$TEST_HOME/.config/kon/openai_auth.json"
 fi
-if [ -f "$HOME/.kon/copilot_auth.json" ]; then
-    cp "$HOME/.kon/copilot_auth.json" "$TEST_HOME/.kon/copilot_auth.json"
+if [ -f "$HOME/.config/kon/copilot_auth.json" ]; then
+    cp "$HOME/.config/kon/copilot_auth.json" "$TEST_HOME/.config/kon/copilot_auth.json"
 fi
 cd "$TEST_DIR" || exit 1
 printf '# Test Project\n' > README.md
@@ -288,7 +288,7 @@ clear_input
 # =============================================================================
 echo "Capturing file system and persisted state..."
 ls -la "$TEST_DIR" > /tmp/kon-test-files.txt 2>/dev/null
-find "$TEST_HOME/.kon/sessions" -type f -name '*.jsonl' -print > /tmp/kon-test-session-files.txt 2>/dev/null || true
+find "$TEST_HOME/.config/kon/sessions" -type f -name '*.jsonl' -print > /tmp/kon-test-session-files.txt 2>/dev/null || true
 capture_config /tmp/kon-test-final-config.txt
 
 # Retry a few times in case the LLM is still finishing file writes

kon_coding_agent-0.4.1/.claude/settings.local.json

@@ -0,0 +1,36 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(uv run *)",
+      "Bash(gh api *)",
+      "Bash(echo \"exit=$?\")",
+      "Bash(git -C /Users/utsav/Workspaces/kon status --short)",
+      "Bash(git -C /Users/utsav/Workspaces/kon diff --stat)",
+      "Bash(git add *)",
+      "Bash(git commit -m ' *)",
+      "Bash(git push *)",
+      "Bash(gh run *)",
+      "Bash(python3 -c ' *)",
+      "Bash(awk -F: '{print $1\": \"$3}')",
+      "Bash(awk -F: '{print $3}')",
+      "Bash(awk -F: '{print $1, $2}')",
+      "Bash(git -C /Users/utsav/Workspaces/kon log --oneline origin/main..HEAD)",
+      "Bash(git -C /Users/utsav/Workspaces/kon log --oneline -10)",
+      "Bash(git -C /Users/utsav/Workspaces/kon show f987ebf --stat=220)",
+      "Bash(git -C /Users/utsav/Workspaces/kon show f987ebf -- src/kon/turn.py)",
+      "Bash(git -C /Users/utsav/Workspaces/kon show fa6b029 --stat)",
+      "Bash(git -C /Users/utsav/Workspaces/kon show fa6b029)",
+      "Bash(git -C /Users/utsav/Workspaces/kon show f987ebf~1:src/kon/turn.py)",
+      "Bash(awk '/^async def run_single_turn/,0')",
+      "Bash(awk '{print length\\($0\\)/4}')",
+      "Bash(git -C /Users/utsav/Workspaces/kon show f987ebf -- tests/)",
+      "Bash(git -C /Users/utsav/Workspaces/kon show 31815a4 --stat)",
+      "Bash(git -C /Users/utsav/Workspaces/kon show 705fb8f --stat)",
+      "Bash(git -C /Users/utsav/Workspaces/kon diff --stat src/kon/ui/app.py)",
+      "Bash(gh issue *)",
+      "Bash(git *)",
+      "Bash(sed -n 250-270p /Users/utsav/Workspaces/kon/src/kon/llm/providers/openai_completions.py)",
+      "Bash(sed -n 200-220p /Users/utsav/Workspaces/kon/src/kon/llm/providers/anthropic.py)"
+    ]
+  }
+}

kon_coding_agent-0.4.1/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v6
+    - name: Install uv
+      uses: astral-sh/setup-uv@v8.2.0
+      with:
+        python-version: "3.13"
+    - name: Build sdist and wheel
+      run: uv build
+    - uses: actions/upload-artifact@v7
+      with:
+        name: dist
+        path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      # Required for PyPI trusted publishing (OIDC).
+      id-token: write
+    steps:
+    - uses: actions/download-artifact@v8
+      with:
+        name: dist
+        path: dist/
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

kon_coding_agent-0.4.1/.github/workflows/test.yml

@@ -0,0 +1,40 @@
+name: Test
+
+on: [push, pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v6
+    - name: Install uv
+      uses: astral-sh/setup-uv@v8.2.0
+      with:
+        python-version: "3.13"
+    - name: Install dependencies
+      run: uv sync --group dev
+    - name: Ruff format
+      run: uv run ruff format --check .
+    - name: Ruff check
+      run: uv run ruff check .
+    - name: Pyright
+      run: uv run python -m pyright .
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+    - uses: actions/checkout@v6
+    - name: Install uv
+      uses: astral-sh/setup-uv@v8.2.0
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: uv sync --group dev
+    - name: Run tests
+      run: uv run python -m pytest -s

kon_coding_agent-0.4.1/.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.16
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format

{kon_coding_agent-0.4.0 → kon_coding_agent-0.4.1}/AGENTS.md

@@ -17,7 +17,7 @@
 
 ## Committing code
 
-- If the user tells you to commit code, look at all the changes and create multile commits if needed bsaed on logical groupings
+- If the user tells you to commit code, look at all the changes and create multiple commits if needed based on logical groupings
 - Follow commit message conventions: `docs:`, `feat:`, `fix:`, `build:`, etc. for the commit prefix
 
 ## Pushing

{kon_coding_agent-0.4.0 → kon_coding_agent-0.4.1}/CHANGELOG.md

@@ -6,6 +6,41 @@ All notable changes to this project will be documented in this file.
 
 - No changes yet.
 
+## 0.4.1 - 2026-06-13
+
+### Added
+
+- Added Windows audio notification support without volume control - @clach04.
+- Added slash-only skills support.
+- Added skill-relative path resolution against each skill directory.
+
+### Changed
+
+- Split UI monoliths and restructured the turn streaming loop.
+- Improved markdown streaming performance with cached rendered blocks.
+- Kept blocking I/O off the UI event loop.
+- Updated CI, PyPI publishing, and pre-commit workflows.
+
+### Fixed
+
+- Skipped mkfifo-dependent tests on Windows - @clach04.
+- Fixed slash-command args for skills without `$ARGUMENTS` placeholders.
+- Updated e2e auth/config/session paths to `~/.config/kon`.
+- Persisted manual shell commands for export and resume.
+- Improved Windows Git Bash path handling.
+- Fixed manually triggered custom skill body expansion.
+- Skipped tool calls with stream-stalled truncated arguments.
+- Preserved error context and retried transient network failures.
+- Fixed skill frontmatter inline comment parsing.
+- Buffered partial streaming markdown lines.
+
+### Docs / Tests
+
+- Aligned web tools docs with default config.
+- Updated stale `.kon/skills` references to `.agents/skills`.
+- Added testing guide, local model guidance, and permission clarifications.
+- Improved Windows path and notification test coverage.
+
 ## 0.4.0 - 2026-05-31
 
 ### Added

{kon_coding_agent-0.4.0 → kon_coding_agent-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kon-coding-agent
-Version: 0.4.0
+Version: 0.4.1
 Summary: Minimal coding agent
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -10,6 +10,7 @@ Requires-Dist: anthropic>=0.79.0
 Requires-Dist: curl-cffi>=0.15.0
 Requires-Dist: ddgs>=9.0.0
 Requires-Dist: html-to-markdown<3.4.0,>=3.3.0
+Requires-Dist: lxml-html-clean>=0.4.3
 Requires-Dist: openai>=2.21.0
 Requires-Dist: pillow>=12.1.1
 Requires-Dist: pydantic>=2.12.5
@@ -34,7 +35,7 @@ Description-Content-Type: text/markdown
   <img src="docs/images/kon-screenshot.png" alt="Kon terminal UI screenshot" width="700" />
 </p>
 
-Kon is a minimal coding agent focused on a tiny core prompt, a small built-in toolset, and project-specific context layered on top only when you want it. The default system prompt stays **under 270 tokens**, and even including the built-in tool descriptions and parameter schemas, the fixed harness stays at about **~1,000 tokens**. The core experience is built around just **6 default tools** plus **2 optional web tools**.
+Kon is a minimal coding agent focused on a tiny core prompt, a small built-in toolset, and project-specific context layered on top only when you want it. The default system prompt stays **under 270 tokens**, and even including the built-in tool descriptions and parameter schemas, the fixed harness stays at about **~1,000 tokens**. The core experience is built around **6 default tools** plus **2 extra web tools** included by the shipped config.
 
 [Kon](https://bleach.fandom.com/wiki/Kon) is named after the artificial soul from *Bleach*.
 
@@ -138,7 +139,7 @@ kon -c
 # resume a specific session by id or unique prefix
 kon -r 3f2a8c1b-...
 
-# enable the optional web tools
+# enable extra web tools for this run
 kon --extra-tools web_search,web_fetch
 ```
 
@@ -182,6 +183,19 @@ uv tool install .
 > [!WARNING]
 > Kon currently targets macOS and Linux. Windows is not tested yet.
 
+### Development and testing
+
+Run the test suite through `uv` so the dev dependencies are active — `pytest-asyncio` comes from the dev group, and a bare `pytest` without it fails every async test:
+
+```bash
+git clone https://github.com/kuutsav/kon
+cd kon
+uv sync --dev
+uv run python -m pytest
+```
+
+**Windows note:** if you see many failures like `async def functions are not natively supported`, you are running a pytest without `pytest-asyncio` — re-run with `uv run python -m pytest` as above. Remaining Windows-specific failures are worth reporting as issues.
+
 ---
 
 ## Why Kon
@@ -192,7 +206,7 @@ Kon tries to stay small in the places that matter most:
 
 - **System prompt under 270 tokens** by default
 - **6 core tools** for everyday coding work
-- **2 optional extra tools** for web lookup and content extraction
+- **2 extra web tools** for web lookup and content extraction in the shipped config
 - **Project instructions are externalized** through `AGENTS.md`
 - **Heavily configurable** defaults that you can tune around model, prompt, permissions, compaction, tools, and UI
 - **Useful features are borrowed selectively** from other agents, like `/handoff` inspired by Amp
@@ -274,24 +288,24 @@ This is the core experience: small, predictable, and enough for most coding task
 
 ### Extra tools
 
-Kon also ships optional built-in tools you can turn on when needed:
+Kon also ships extra built-in tools beyond the 6 core tools. The shipped config enables these web tools by default:
 
-| Tool | Purpose | How to enable |
+| Tool | Purpose | Config |
 | --- | --- | --- |
-| `web_search` | Search the web with DuckDuckGo | `--extra-tools web_search,web_fetch` or config |
+| `web_search` | Search the web with DuckDuckGo | `extra = ["web_search", "web_fetch"]` |
 | `web_fetch` | Fetch and extract clean page content | Usually paired with `web_search` |
 
-Enable them from the CLI:
+You can also add extra tools for a single run from the CLI:
 
 ```bash
 kon --extra-tools web_search,web_fetch
 ```
 
-Or in `~/.config/kon/config.toml`:
+To disable web tools, remove them from `~/.config/kon/config.toml`:
 
 ```toml
 [tools]
-extra = ["web_search", "web_fetch"]
+extra = []
 ```
 
 ---
@@ -493,9 +507,12 @@ Important fields:
 
 - `name` - skill identifier
 - `description` - used for discovery and prompt context
-- `register_cmd` - if `true`, exposes the skill as a slash command and includes it in the `/cmd` popup for manual triggering
+- `register_cmd` - if `true`, exposes the skill as a slash command and includes it in the `/cmd` popup for manual triggering; use `only` to register it as a slash command without including it in the system prompt
 - `cmd_info` - short help text for the slash menu
 
+> [!NOTE]
+> Installed skills do **not** appear as slash commands by default — without `register_cmd` they are only described to the model, which invokes them on its own when relevant. Add `register_cmd: true` to a skill's frontmatter to trigger it manually as `/<skill-name>`.
+
 Validation highlights:
 
 - lowercase letters, numbers, and `-` only
@@ -558,7 +575,7 @@ Kon supports two permission modes:
 | `prompt` | Ask before mutating tool calls |
 | `auto` | Skip approval prompts |
 
-In `prompt` mode, non-mutating tools are allowed automatically, and some clearly read-only shell commands are also allowed.
+In `prompt` mode, non-mutating tools are allowed automatically, and some clearly read-only shell commands are also allowed. This includes web tools: `web_search` and `web_fetch` are read-only, so they run **without an approval prompt** even in `prompt` mode. If you don't want the agent reaching the network at all, remove them from the `[tools] extra` config.
 
 Use `/permissions` to switch modes for the current session and persist the change to config.
 

{kon_coding_agent-0.4.0 → kon_coding_agent-0.4.1}/README.md

@@ -14,7 +14,7 @@
   <img src="docs/images/kon-screenshot.png" alt="Kon terminal UI screenshot" width="700" />
 </p>
 
-Kon is a minimal coding agent focused on a tiny core prompt, a small built-in toolset, and project-specific context layered on top only when you want it. The default system prompt stays **under 270 tokens**, and even including the built-in tool descriptions and parameter schemas, the fixed harness stays at about **~1,000 tokens**. The core experience is built around just **6 default tools** plus **2 optional web tools**.
+Kon is a minimal coding agent focused on a tiny core prompt, a small built-in toolset, and project-specific context layered on top only when you want it. The default system prompt stays **under 270 tokens**, and even including the built-in tool descriptions and parameter schemas, the fixed harness stays at about **~1,000 tokens**. The core experience is built around **6 default tools** plus **2 extra web tools** included by the shipped config.
 
 [Kon](https://bleach.fandom.com/wiki/Kon) is named after the artificial soul from *Bleach*.
 
@@ -118,7 +118,7 @@ kon -c
 # resume a specific session by id or unique prefix
 kon -r 3f2a8c1b-...
 
-# enable the optional web tools
+# enable extra web tools for this run
 kon --extra-tools web_search,web_fetch
 ```
 
@@ -162,6 +162,19 @@ uv tool install .
 > [!WARNING]
 > Kon currently targets macOS and Linux. Windows is not tested yet.
 
+### Development and testing
+
+Run the test suite through `uv` so the dev dependencies are active — `pytest-asyncio` comes from the dev group, and a bare `pytest` without it fails every async test:
+
+```bash
+git clone https://github.com/kuutsav/kon
+cd kon
+uv sync --dev
+uv run python -m pytest
+```
+
+**Windows note:** if you see many failures like `async def functions are not natively supported`, you are running a pytest without `pytest-asyncio` — re-run with `uv run python -m pytest` as above. Remaining Windows-specific failures are worth reporting as issues.
+
 ---
 
 ## Why Kon
@@ -172,7 +185,7 @@ Kon tries to stay small in the places that matter most:
 
 - **System prompt under 270 tokens** by default
 - **6 core tools** for everyday coding work
-- **2 optional extra tools** for web lookup and content extraction
+- **2 extra web tools** for web lookup and content extraction in the shipped config
 - **Project instructions are externalized** through `AGENTS.md`
 - **Heavily configurable** defaults that you can tune around model, prompt, permissions, compaction, tools, and UI
 - **Useful features are borrowed selectively** from other agents, like `/handoff` inspired by Amp
@@ -254,24 +267,24 @@ This is the core experience: small, predictable, and enough for most coding task
 
 ### Extra tools
 
-Kon also ships optional built-in tools you can turn on when needed:
+Kon also ships extra built-in tools beyond the 6 core tools. The shipped config enables these web tools by default:
 
-| Tool | Purpose | How to enable |
+| Tool | Purpose | Config |
 | --- | --- | --- |
-| `web_search` | Search the web with DuckDuckGo | `--extra-tools web_search,web_fetch` or config |
+| `web_search` | Search the web with DuckDuckGo | `extra = ["web_search", "web_fetch"]` |
 | `web_fetch` | Fetch and extract clean page content | Usually paired with `web_search` |
 
-Enable them from the CLI:
+You can also add extra tools for a single run from the CLI:
 
 ```bash
 kon --extra-tools web_search,web_fetch
 ```
 
-Or in `~/.config/kon/config.toml`:
+To disable web tools, remove them from `~/.config/kon/config.toml`:
 
 ```toml
 [tools]
-extra = ["web_search", "web_fetch"]
+extra = []
 ```
 
 ---
@@ -473,9 +486,12 @@ Important fields:
 
 - `name` - skill identifier
 - `description` - used for discovery and prompt context
-- `register_cmd` - if `true`, exposes the skill as a slash command and includes it in the `/cmd` popup for manual triggering
+- `register_cmd` - if `true`, exposes the skill as a slash command and includes it in the `/cmd` popup for manual triggering; use `only` to register it as a slash command without including it in the system prompt
 - `cmd_info` - short help text for the slash menu
 
+> [!NOTE]
+> Installed skills do **not** appear as slash commands by default — without `register_cmd` they are only described to the model, which invokes them on its own when relevant. Add `register_cmd: true` to a skill's frontmatter to trigger it manually as `/<skill-name>`.
+
 Validation highlights:
 
 - lowercase letters, numbers, and `-` only
@@ -538,7 +554,7 @@ Kon supports two permission modes:
 | `prompt` | Ask before mutating tool calls |
 | `auto` | Skip approval prompts |
 
-In `prompt` mode, non-mutating tools are allowed automatically, and some clearly read-only shell commands are also allowed.
+In `prompt` mode, non-mutating tools are allowed automatically, and some clearly read-only shell commands are also allowed. This includes web tools: `web_search` and `web_fetch` are read-only, so they run **without an approval prompt** even in `prompt` mode. If you don't want the agent reaching the network at all, remove them from the `[tools] extra` config.
 
 Use `/permissions` to switch modes for the current session and persist the change to config.
 

{kon_coding_agent-0.4.0 → kon_coding_agent-0.4.1}/docs/e2e-test-coverage-review.md

@@ -6,14 +6,14 @@ This note captures the current tmux E2E coverage, when it was last materially up
 
 The current tmux E2E harness lives in the repo-local Kon skill:
 
-- `.kon/skills/kon-tmux-test/SKILL.md`
-- `.kon/skills/kon-tmux-test/run-e2e-tests.sh`
+- `.agents/skills/kon-tmux-test/SKILL.md`
+- `.agents/skills/kon-tmux-test/run-e2e-tests.sh`
 
 The main script launches Kon in a detached tmux session, drives keyboard input with `tmux send-keys`, captures pane output to `/tmp/kon-test-*.txt`, and relies on the reviewing agent/user to evaluate those captured outputs.
 
 ## Last material update
 
-Git history for `.kon/skills/kon-tmux-test` shows the last material test update was:
+Git history for `.agents/skills/kon-tmux-test` shows the last material test update was:
 
 ```text
 ae88aae 2026-03-18 21:18:04 +0530 test: make tmux e2e tab completion cases repo-deterministic
@@ -44,7 +44,7 @@ The coverage is strongest for basic UI triggers and tab completion. It is weaker
 
 ## Current documentation drift
 
-`.kon/skills/kon-tmux-test/SKILL.md` is partially stale compared with `run-e2e-tests.sh`.
+`.agents/skills/kon-tmux-test/SKILL.md` is partially stale compared with `run-e2e-tests.sh`.
 
 Examples:
 
@@ -165,7 +165,7 @@ Several of these can be covered with deterministic negative-state tests, even be
 | --- | --- |
 | Built-in `/init` appears | Slash menu includes `/init` with its guided setup description |
 | `/init` selection behavior | Selecting `/init` inserts/submits the skill trigger path correctly without breaking normal slash-command handling |
-| Custom registered skill | Seed a temp project `.kon/skills/<name>/SKILL.md` with `register_cmd: true`, launch Kon, verify command appears in slash menu |
+| Custom registered skill | Seed a temp project `.agents/skills/<name>/SKILL.md` with `register_cmd: true`, launch Kon, verify command appears in slash menu |
 | Skill preview in resume list | If a skill-triggered session is persisted, `/resume` preview shows `/skill-name ...` instead of raw internal prompt scaffolding |
 
 ### P1: Queue and steer behavior
@@ -196,7 +196,7 @@ Several of these can be covered with deterministic negative-state tests, even be
 ## Suggested implementation order
 
 1. Isolate `HOME` and test config/session directories in the tmux harness.
-2. Update `.kon/skills/kon-tmux-test/SKILL.md` to match the current script.
+2. Update `.agents/skills/kon-tmux-test/SKILL.md` to match the current script.
 3. Add P0 runtime-mode and info-bar tests.
 4. Add deterministic command negative-state tests for `/compact`, `/handoff`, `/copy`, and `/export`.
 5. Add session resume/continue/delete tests using seeded fixtures.

{kon_coding_agent-0.4.0 → kon_coding_agent-0.4.1}/docs/local-models.md

@@ -2,6 +2,12 @@
 
 This document provides detailed information about running and configuring local models with Kon.
 
+## Choosing a model
+
+Kon leans heavily on tool calling: every file read, edit, search, and skill invocation is a structured tool call. Very small models (roughly 8B and below, or aggressive quantizations) often produce malformed tool calls, ignore tools entirely, or fail to follow skill instructions — which looks like Kon "not working" when it's the model that can't drive the harness. If a tiny model keeps narrating instead of acting, or tool calls fail to parse, try a larger model before filing a bug.
+
+The combinations in the table below are known to work and are a good baseline; among them, prefer the largest one your hardware can serve at a usable speed.
+
 ## Tested Models
 
 > Tested on llama server build b8740

{kon_coding_agent-0.4.0 → kon_coding_agent-0.4.1}/pyproject.toml

@@ -14,7 +14,7 @@ default = true
 
 [project]
 name = "kon-coding-agent"
-version = "0.4.0"
+version = "0.4.1"
 description = "Minimal coding agent"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -25,6 +25,7 @@ dependencies = [
     "curl-cffi>=0.15.0",
     "ddgs>=9.0.0",
     "html-to-markdown>=3.3.0,<3.4.0",
+    "lxml-html-clean>=0.4.3",
     "openai>=2.21.0",
     "pillow>=12.1.1",
     "pydantic>=2.12.5",

{kon_coding_agent-0.4.0 → kon_coding_agent-0.4.1}/src/kon/cli.py

@@ -89,7 +89,7 @@ def main() -> None:
             )
         )
 
-    from .ui.app import run_tui
+    from .ui.launch import run_tui
 
     run_tui(args, extra_tools=extra_tools)