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

{kon_coding_agent-0.3.11 → kon_coding_agent-0.4.1}/.agents/skills/kon-release-publish/SKILL.md

@@ -24,7 +24,7 @@ Use this skill when the user asks to cut a new Kon version, tag it, publish to P
 ## Files to bump
 
 - `pyproject.toml` → `[project].version`
-- `src/kon/ui/app.py` → fallback `VERSION = "..."`
+- `src/kon/version.py` → fallback `VERSION = "..."`
 - `uv.lock` → local package version block
 
 ## Release workflow

{kon_coding_agent-0.3.11 → 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.3.11 → 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.3.11 → 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.3.11 → kon_coding_agent-0.4.1}/CHANGELOG.md

@@ -6,6 +6,64 @@ 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
+
+- Added non-interactive `-p`/`--prompt` headless mode - @Meltedd.
+- Added pull request autocomplete.
+- Added review slash skill and updated review rubric.
+- Added thinking display settings.
+- Added diff rendering improvements.
+- Added git context toggle to settings UI and exported `set_git_context`.
+
+### Changed
+
+- Extracted Textual-free CLI entry point.
+
+### Fixed
+
+- Aligned agent context paths.
+- Clipped diff output lines.
+- Used warning symbol for chat notices.
+- Replaced `math.fma` for Python 3.12 compatibility.
+- Removed unsupported GLM-4.7 and GPT models below 5.5 from Copilot and Codex providers.
+
 ## 0.3.11 - 2026-05-29
 
 ### Added

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kon-coding-agent
-Version: 0.3.11
+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*.
 
@@ -89,34 +90,48 @@ kon
 ```text
 usage: kon [-h] [--model MODEL]
            [--provider {azure-ai-foundry,deepseek,github-copilot,openai,openai-codex,openai-responses,zhipu}]
-           [--api-key API_KEY] [--base-url BASE_URL] [--continue]
-           [--resume RESUME_SESSION] [--version]
-           [--extra-tools EXTRA_TOOLS]
+           [--prompt [PROMPT]] [--api-key API_KEY] [--base-url BASE_URL]
+           [--openai-compat-auth {auto,required,none}]
+           [--anthropic-compat-auth {auto,required,none}]
+           [--insecure-skip-verify] [--continue] [--resume RESUME_SESSION]
+           [--version] [--extra-tools EXTRA_TOOLS]
 
-Kon TUI
+Kon
 
 options:
   -h, --help            show this help message and exit
   --model, -m MODEL     Model to use
-  --provider, -p {azure-ai-foundry,deepseek,github-copilot,openai,openai-codex,openai-responses,zhipu}
+  --provider {azure-ai-foundry,deepseek,github-copilot,openai,openai-codex,openai-responses,zhipu}
                         Provider to use
+  --prompt, -p [PROMPT]
+                        Run a single prompt non-interactively, then exit (omit
+                        the value or pipe stdin to read the prompt from stdin)
   --api-key, -k API_KEY
                         API key
   --base-url, -u BASE_URL
                         Base URL for API
+  --openai-compat-auth {auto,required,none}
+                        Auth mode for OpenAI-compatible endpoints
+  --anthropic-compat-auth {auto,required,none}
+                        Auth mode for Anthropic-compatible endpoints
+  --insecure-skip-verify
+                        Skip TLS verification (e.g. self-signed certs on local
+                        providers)
   --continue, -c        Resume the most recent session
   --resume, -r RESUME_SESSION
-                        Resume a specific session by ID (full or unique prefix)
+                        Resume a specific session by ID (full or unique
+                        prefix)
   --version             show program's version number and exit
   --extra-tools EXTRA_TOOLS
-                        Comma-separated extra tools to enable (e.g. web_search,web_fetch)
+                        Comma-separated extra tools to enable (e.g.
+                        web_search,web_fetch)
 ```
 
 ### Common examples
 
 ```bash
-# choose a model explicitly
-kon -p openai-codex -m gpt-5.4
+# choose a provider and model explicitly
+kon --provider openai-codex -m gpt-5.4
 
 # continue your latest session
 kon -c
@@ -124,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
 ```
 
@@ -140,6 +155,23 @@ kon --extra-tools web_search,web_fetch
 !!find . -name "*.py" | head -20
 ```
 
+### Non-interactive
+
+Run a single prompt headlessly with `-p`/`--prompt`, then exit:
+
+```bash
+# pass the prompt inline
+kon -p "fix the failing test"
+
+# read the prompt from stdin
+cat task.md | kon -p
+
+# capture the final response
+kon -p "summarize this module" > out.txt
+```
+
+In this mode tools run **auto-approved** (no confirmation prompts). The final assistant response is printed to stdout on a clean finish; errors go to stderr. Exit codes: `0` completed, `1` error, `2` startup error (empty prompt or provider/init failure), `3` hit the max-turn limit. Session flags (`-c`/`--continue`, `-r`/`--resume`) aren't supported in this mode.
+
 ### Install from source
 
 ```bash
@@ -151,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
@@ -161,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
@@ -175,7 +220,7 @@ If you want a coding agent you can read, understand, fork, and adapt without inh
 Kon stores config at:
 
 ```text
-~/.kon/config.toml
+~/.config/kon/config.toml
 ```
 
 It is created automatically on first run, and old schemas are migrated forward automatically when needed.
@@ -243,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 `~/.kon/config.toml`:
+To disable web tools, remove them from `~/.config/kon/config.toml`:
 
 ```toml
 [tools]
-extra = ["web_search", "web_fetch"]
+extra = []
 ```
 
 ---
@@ -369,7 +414,7 @@ Kon supports direct shell command execution from the input box using two prefixe
 Kon stores sessions as append-only **JSONL** files in:
 
 ```text
-~/.kon/sessions/
+~/.config/kon/sessions/
 ```
 
 That keeps sessions easy to inspect, archive, and move around.
@@ -429,8 +474,8 @@ Kon loads project guidance from `AGENTS.md` or `CLAUDE.md` files into the system
 
 Load order:
 
-1. `~/.kon/AGENTS.md`
-2. matching ancestor directories from git root (or home) down to the current working directory
+1. `~/.config/kon/AGENTS.md`
+2. matching `AGENTS.md` or `CLAUDE.md` files in ancestor directories from git root (or home) down to the current working directory
 
 Use these files for repo conventions, test commands, code style notes, deployment steps, or anything else you want loaded automatically.
 
@@ -438,8 +483,8 @@ Use these files for repo conventions, test commands, code style notes, deploymen
 
 Skills are reusable instruction packs discovered from:
 
-- project: `.kon/skills/`
-- global: `~/.kon/skills/`
+- project: `.agents/skills/`
+- global: `~/.agents/skills/`
 
 Each skill lives in its own directory with a `SKILL.md` file.
 
@@ -462,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
@@ -512,7 +560,7 @@ kon --provider deepseek --model deepseek-v4-flash
 
 ### Local models
 
-Kon works well with local models served through an OpenAI-compatible endpoint. For one-off launches, you can force unauthenticated local behavior with `--openai-compat-auth none` or `--anthropic-compat-auth none`. To make that persistent across sessions, set `[llm.auth] openai_compat = "auto"|"none"` and/or `anthropic_compat = "auto"|"none"` in `~/.kon/config.toml`.
+Kon works well with local models served through an OpenAI-compatible endpoint. For one-off launches, you can force unauthenticated local behavior with `--openai-compat-auth none` or `--anthropic-compat-auth none`. To make that persistent across sessions, set `[llm.auth] openai_compat = "auto"|"none"` and/or `anthropic_compat = "auto"|"none"` in `~/.config/kon/config.toml`.
 
 More notes, tested models, and examples live in [docs/local-models.md](docs/local-models.md).
 
@@ -527,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.