kon-coding-agent 0.3.1__tar.gz → 0.3.3__tar.gz

{kon_coding_agent-0.3.1 → kon_coding_agent-0.3.3}/AGENTS.md

@@ -7,7 +7,7 @@
 
 ## Testing
 
-- Use `uv run pytest` for testing in general; after edits/writes
+- Use `uv run python -m pytest` for testing in general; after edits/writes
 - If the user asks for e2e tests then run the kon-tmux e2e test if available
 
 ## Committing code
@@ -17,5 +17,5 @@
 
 ## Pushing
 
-- If the user asks you to push code, run these first before doing so: `uv run ruff format .`, `uv run ruff check .`, `uv run pyright .` and `uv run pytest` in parallel (same tool call)
+- If the user asks you to push code, run these first before doing so: `uv run ruff format .`, `uv run ruff check .`, `uv run python -m pyright .` and `uv run python -m pytest` in parallel (same tool call)
 - Only if these all pass without issues should you push otherwise report the warnings/errors back to user and ask for next steps

{kon_coding_agent-0.3.1 → kon_coding_agent-0.3.3}/CHANGELOG.md

@@ -6,6 +6,22 @@ All notable changes to this project will be documented in this file.
 
 - No changes yet.
 
+## 0.3.2 - 2026-03-22
+
+### Added
+
+- Added a `collapse_thinking` config flag to control thinking block display.
+- Added a Ghostty theme preview script.
+
+### Changed
+
+- Improved theme and model picker indicators.
+- Refactored tool display helpers into shared `truncate_text` and `shorten_path` utilities.
+
+### Fixed
+
+- Fixed duplicate skill warnings coming from the home directory.
+
 ## 0.3.1 - 2026-03-21
 
 ### Added
@@ -14,7 +30,6 @@ All notable changes to this project will be documented in this file.
 - Added tool permission controls with bash safety analysis - @Meltedd.
 - Added popular built-in themes.
 - Added tool previews in approval prompts.
-- Added run token throughput metrics.
 
 ### Changed
 

{kon_coding_agent-0.3.1 → kon_coding_agent-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kon-coding-agent
-Version: 0.3.1
+Version: 0.3.3
 Summary: Minimal coding agent
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -167,7 +167,7 @@ Here is the full config shape:
 
 ```toml
 [meta]
-config_version = 3
+config_version = 4
 
 [llm]
 default_provider = "openai-codex"
@@ -176,6 +176,10 @@ default_base_url = ""
 default_thinking_level = "high"
 tool_call_idle_timeout_seconds = 180
 
+[llm.auth]
+openai_compat = "auto"
+anthropic_compat = "auto"
+
 [llm.system_prompt]
 git_context = true
 content = """You are an expert coding assistant called Kon.
@@ -248,8 +252,9 @@ Kon is built around a terminal UI that stays simple but practical.
 | --- | --- |
 | File reference | Type `@` to fuzzy-search files and folders in the current project |
 | Path completion | Press **Tab** to complete paths like `./`, `../`, `~`, quoted paths, and absolute paths |
-| Queued prompts | You can submit follow-up prompts while the agent is still running |
-| Queue limit | Up to **5** queued prompts |
+| Queued prompts | Press **Enter** while the agent is running to queue a follow-up prompt |
+| Steer queue | Press **Alt+Enter** to queue a steer message that is processed before normal queued prompts |
+| Queue limit | Up to **5** normal queued prompts and **5** steer messages |
 | Model switching | Use `/model` to switch interactively |
 | Session browsing | Use `/resume` to browse prior sessions |
 
@@ -437,73 +442,12 @@ kon --provider openai --model some-model --api-key "$OPENAI_API_KEY"
 
 ### Local models
 
-Kon works well with local models served through an OpenAI-compatible endpoint.
-
-Example with `llama-server`:
-
-```bash
-./llama-server -m <models-dir>/GLM-4.7-Flash-GGUF/GLM-4.7-Flash-Q4_K_M.gguf \
-  -n 8192 \
-  -c 64000
-
-kon --model zai-org/glm-4.7-flash \
-  --provider openai \
-  --base-url http://localhost:8080/v1 \
-  --api-key ""
-```
+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`.
 
 More notes, tested models, and examples live in [docs/local-models.md](docs/local-models.md).
 
 ---
 
-### Configuration
-
-Kon stores config at:
-
-```text
-~/.kon/config.toml
-```
-
-It is created automatically on first run, and old schemas are migrated forward automatically when needed.
-
-Users are recommended to customize this config based on their model, workflow, safety preferences, and UI taste.
-
-Here is the full config shape:
-
-```toml
-[meta]
-config_version = 3
-
-[llm]
-default_provider = "openai-codex"
-default_model = "gpt-5.4"
-default_base_url = ""
-default_thinking_level = "high"
-tool_call_idle_timeout_seconds = 180
-
-[llm.system_prompt]
-git_context = true
-content = """You are an expert coding assistant called Kon.
-..."""
-
-[compaction]
-on_overflow = "continue"
-buffer_tokens = 20000
-
-[agent]
-max_turns = 500
-default_context_window = 200000
-
-[tools]
-extra = ["web_search", "web_fetch"]
-
-[ui]
-theme = "gruvbox-dark"
-
-[permissions]
-mode = "prompt"
-```
-
 ### Permissions
 
 Kon supports two permission modes:
@@ -526,9 +470,8 @@ Kon depends on a few fast CLI tools for file discovery and search:
 
 - **[`fd`](https://github.com/sharkdp/fd)** - required for fast file discovery
 - **[`ripgrep`](https://github.com/BurntSushi/ripgrep)** - required for fast content search
-- **[`eza`](https://github.com/eza-community/eza)** - optional
 
-If `fd` or `rg` are missing, Kon can download them automatically. `eza` is optional and mainly useful for cleaner, `.gitignore`-aware directory listings.
+If `fd` or `rg` are missing, Kon can download them automatically.
 
 ---
 

{kon_coding_agent-0.3.1 → kon_coding_agent-0.3.3}/README.md

@@ -149,7 +149,7 @@ Here is the full config shape:
 
 ```toml
 [meta]
-config_version = 3
+config_version = 4
 
 [llm]
 default_provider = "openai-codex"
@@ -158,6 +158,10 @@ default_base_url = ""
 default_thinking_level = "high"
 tool_call_idle_timeout_seconds = 180
 
+[llm.auth]
+openai_compat = "auto"
+anthropic_compat = "auto"
+
 [llm.system_prompt]
 git_context = true
 content = """You are an expert coding assistant called Kon.
@@ -230,8 +234,9 @@ Kon is built around a terminal UI that stays simple but practical.
 | --- | --- |
 | File reference | Type `@` to fuzzy-search files and folders in the current project |
 | Path completion | Press **Tab** to complete paths like `./`, `../`, `~`, quoted paths, and absolute paths |
-| Queued prompts | You can submit follow-up prompts while the agent is still running |
-| Queue limit | Up to **5** queued prompts |
+| Queued prompts | Press **Enter** while the agent is running to queue a follow-up prompt |
+| Steer queue | Press **Alt+Enter** to queue a steer message that is processed before normal queued prompts |
+| Queue limit | Up to **5** normal queued prompts and **5** steer messages |
 | Model switching | Use `/model` to switch interactively |
 | Session browsing | Use `/resume` to browse prior sessions |
 
@@ -419,73 +424,12 @@ kon --provider openai --model some-model --api-key "$OPENAI_API_KEY"
 
 ### Local models
 
-Kon works well with local models served through an OpenAI-compatible endpoint.
-
-Example with `llama-server`:
-
-```bash
-./llama-server -m <models-dir>/GLM-4.7-Flash-GGUF/GLM-4.7-Flash-Q4_K_M.gguf \
-  -n 8192 \
-  -c 64000
-
-kon --model zai-org/glm-4.7-flash \
-  --provider openai \
-  --base-url http://localhost:8080/v1 \
-  --api-key ""
-```
+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`.
 
 More notes, tested models, and examples live in [docs/local-models.md](docs/local-models.md).
 
 ---
 
-### Configuration
-
-Kon stores config at:
-
-```text
-~/.kon/config.toml
-```
-
-It is created automatically on first run, and old schemas are migrated forward automatically when needed.
-
-Users are recommended to customize this config based on their model, workflow, safety preferences, and UI taste.
-
-Here is the full config shape:
-
-```toml
-[meta]
-config_version = 3
-
-[llm]
-default_provider = "openai-codex"
-default_model = "gpt-5.4"
-default_base_url = ""
-default_thinking_level = "high"
-tool_call_idle_timeout_seconds = 180
-
-[llm.system_prompt]
-git_context = true
-content = """You are an expert coding assistant called Kon.
-..."""
-
-[compaction]
-on_overflow = "continue"
-buffer_tokens = 20000
-
-[agent]
-max_turns = 500
-default_context_window = 200000
-
-[tools]
-extra = ["web_search", "web_fetch"]
-
-[ui]
-theme = "gruvbox-dark"
-
-[permissions]
-mode = "prompt"
-```
-
 ### Permissions
 
 Kon supports two permission modes:
@@ -508,9 +452,8 @@ Kon depends on a few fast CLI tools for file discovery and search:
 
 - **[`fd`](https://github.com/sharkdp/fd)** - required for fast file discovery
 - **[`ripgrep`](https://github.com/BurntSushi/ripgrep)** - required for fast content search
-- **[`eza`](https://github.com/eza-community/eza)** - optional
 
-If `fd` or `rg` are missing, Kon can download them automatically. `eza` is optional and mainly useful for cleaner, `.gitignore`-aware directory listings.
+If `fd` or `rg` are missing, Kon can download them automatically.
 
 ---
 

{kon_coding_agent-0.3.1 → kon_coding_agent-0.3.3}/docs/local-models.md

@@ -20,9 +20,23 @@ Run a local model using llama-server with the following command:
   -c 65536
 ```
 
-Then start kon:
+Then start Kon for a one-off local session:
 
 ```bash
-kon --model unsloth/Qwen3.5-9B-GGUF --provider openai --base-url http://localhost:5000/v1 --api-key ""
+kon --model unsloth/Qwen3.5-9B-GGUF --provider openai \
+  --base-url http://localhost:5000/v1 \
+  --openai-compat-auth none
+```
+
+If this is your default setup, put it in `~/.kon/config.toml` instead:
+
+```toml
+[llm]
+default_provider = "openai"
+default_model = "unsloth/Qwen3.5-9B-GGUF"
+default_base_url = "http://localhost:5000/v1"
+
+[llm.auth]
+openai_compat = "auto" # or "none" to always inject a placeholder key
 ```
 

{kon_coding_agent-0.3.1 → kon_coding_agent-0.3.3}/pyproject.toml

@@ -14,7 +14,7 @@ default = true
 
 [project]
 name = "kon-coding-agent"
-version = "0.3.1"
+version = "0.3.3"
 description = "Minimal coding agent"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -36,6 +36,7 @@ dev = [
  "pyright>=1.1.408",
  "pytest>=9.0.2",
  "pytest-asyncio>=1.3.0",
+ "ruff>=0.15.8",
  "twine>=5.1.1",
 ]
 

kon_coding_agent-0.3.3/scripts/show_themes.py

@@ -0,0 +1,216 @@
+from __future__ import annotations
+
+import argparse
+import subprocess
+import sys
+import time
+from pathlib import Path
+
+KON_THEME_TO_GHOSTTY_THEME = {
+    "catppuccin-latte": "Catppuccin Latte",
+    "catppuccin-mocha": "Catppuccin Mocha",
+    "dracula": "Dracula",
+    "github-dark": "GitHub Dark",
+    "github-light": "GitHub Light Default",
+    "gruvbox-dark": "Gruvbox Dark",
+    "gruvbox-light": "Gruvbox Light",
+    "nord": "Nord",
+    "one-dark": "Atom One Dark",
+    "one-light": "Atom One Light",
+    "solarized-dark": "Builtin Solarized Dark",
+    "solarized-light": "Builtin Solarized Light",
+    "tokyo-day": "TokyoNight Day",
+    "tokyo-night": "TokyoNight Night",
+}
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "--project-dir",
+        type=Path,
+        default=Path.cwd(),
+        help="Directory to open before running `uv run kon -c`.",
+    )
+    parser.add_argument(
+        "--ghostty-config",
+        type=Path,
+        default=Path.home() / ".config/ghostty/config",
+        help="Ghostty config file to rewrite during previews.",
+    )
+    parser.add_argument(
+        "--kon-config",
+        type=Path,
+        default=Path.home() / ".kon/config.toml",
+        help="Kon config file to rewrite during previews.",
+    )
+    parser.add_argument(
+        "--duration", type=float, default=10.0, help="How long each preview stays open in seconds."
+    )
+    parser.add_argument(
+        "--pause", type=float, default=1.5, help="Pause between previews in seconds."
+    )
+    parser.add_argument(
+        "--ghostty-app",
+        type=Path,
+        default=Path("/Applications/Ghostty.app"),
+        help="Path to Ghostty.app for launching new macOS instances.",
+    )
+    return parser.parse_args()
+
+
+def list_ghostty_themes() -> set[str]:
+    result = subprocess.run(
+        ["ghostty", "+list-themes"], check=True, capture_output=True, text=True
+    )
+    themes = set()
+    for line in result.stdout.splitlines():
+        theme = line.strip()
+        if not theme:
+            continue
+        if theme.endswith("(resources)"):
+            theme = theme[: -len("(resources)")].rstrip()
+        themes.add(theme)
+    return themes
+
+
+def ensure_theme_mapping_is_valid(available_themes: set[str]) -> None:
+    missing = {
+        kon_theme: ghostty_theme
+        for kon_theme, ghostty_theme in KON_THEME_TO_GHOSTTY_THEME.items()
+        if ghostty_theme not in available_themes
+    }
+    if missing:
+        lines = ["Missing Ghostty theme mappings:"]
+        for kon_theme, ghostty_theme in missing.items():
+            lines.append(f"  {kon_theme} -> {ghostty_theme}")
+        raise RuntimeError("\n".join(lines))
+
+
+def replace_or_append_theme_line(config_text: str, theme_name: str) -> str:
+    lines = config_text.splitlines()
+    in_ui_section = False
+    ui_section_found = False
+
+    for index, line in enumerate(lines):
+        stripped = line.strip()
+        if stripped.startswith("[") and stripped.endswith("]"):
+            if stripped == "[ui]":
+                in_ui_section = True
+                ui_section_found = True
+                continue
+            if in_ui_section:
+                lines.insert(index, f'theme = "{theme_name}"')
+                return "\n".join(lines) + "\n"
+            in_ui_section = False
+            continue
+
+        if in_ui_section and stripped.startswith("theme") and "=" in stripped:
+            lines[index] = f'theme = "{theme_name}"'
+            return "\n".join(lines) + "\n"
+
+    if ui_section_found:
+        lines.append(f'theme = "{theme_name}"')
+        return "\n".join(lines) + "\n"
+
+    suffix = "\n" if config_text.endswith("\n") or not config_text else "\n\n"
+    return f'{config_text}{suffix}[ui]\ntheme = "{theme_name}"\n'
+
+
+def write_ghostty_config(config_path: Path, theme_name: str) -> None:
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+    config_path.write_text(f"theme = {theme_name}\n", encoding="utf-8")
+
+
+def write_kon_theme(config_path: Path, theme_name: str) -> None:
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+    original = config_path.read_text(encoding="utf-8") if config_path.exists() else ""
+    updated = replace_or_append_theme_line(original, theme_name)
+    config_path.write_text(updated, encoding="utf-8")
+
+
+def sh_quote(value: str) -> str:
+    return "'" + value.replace("'", "'\"'\"'") + "'"
+
+
+def launch_preview(ghostty_app: Path, project_dir: Path, duration: float) -> None:
+    trap_cmd = (
+        'trap \'test -n "$kon_pid" && kill -TERM "$kon_pid" 2>/dev/null || true\' EXIT INT TERM'
+    )
+    shell_script = (
+        f"cd {sh_quote(str(project_dir))} && "
+        "kon_pid='' && "
+        f"{trap_cmd} && "
+        "uv run kon -c & kon_pid=$! && "
+        f"sleep {duration} && "
+        'kill -TERM "$kon_pid" 2>/dev/null || true && '
+        'wait "$kon_pid" 2>/dev/null || true'
+    )
+    subprocess.run(
+        [
+            "open",
+            "-na",
+            str(ghostty_app),
+            "--args",
+            f"--working-directory={project_dir}",
+            "-e",
+            "sh",
+            "-lc",
+            shell_script,
+        ],
+        check=True,
+    )
+
+
+def main() -> int:
+    args = parse_args()
+    project_dir = args.project_dir.expanduser().resolve()
+    ghostty_config_path = args.ghostty_config.expanduser()
+    kon_config_path = args.kon_config.expanduser()
+    ghostty_app = args.ghostty_app.expanduser()
+
+    if not project_dir.exists():
+        raise FileNotFoundError(f"Project directory does not exist: {project_dir}")
+    if not ghostty_app.exists():
+        raise FileNotFoundError(f"Ghostty app not found: {ghostty_app}")
+
+    available_themes = list_ghostty_themes()
+    ensure_theme_mapping_is_valid(available_themes)
+
+    original_ghostty_config = (
+        ghostty_config_path.read_text(encoding="utf-8") if ghostty_config_path.exists() else None
+    )
+    original_kon_config = (
+        kon_config_path.read_text(encoding="utf-8") if kon_config_path.exists() else None
+    )
+
+    try:
+        for kon_theme, ghostty_theme in KON_THEME_TO_GHOSTTY_THEME.items():
+            print(f"Previewing kon={kon_theme} ghostty={ghostty_theme}")
+            write_kon_theme(kon_config_path, kon_theme)
+            write_ghostty_config(ghostty_config_path, ghostty_theme)
+            launch_preview(ghostty_app, project_dir, args.duration)
+            time.sleep(args.duration + args.pause + 2)
+    finally:
+        if original_kon_config is None:
+            if kon_config_path.exists():
+                kon_config_path.unlink()
+        else:
+            kon_config_path.write_text(original_kon_config, encoding="utf-8")
+
+        if original_ghostty_config is None:
+            if ghostty_config_path.exists():
+                ghostty_config_path.unlink()
+        else:
+            ghostty_config_path.write_text(original_ghostty_config, encoding="utf-8")
+
+    print("Done. Restored Ghostty and kon config files.")
+    return 0
+
+
+if __name__ == "__main__":
+    try:
+        raise SystemExit(main())
+    except KeyboardInterrupt as exc:
+        print("Interrupted.", file=sys.stderr)
+        raise SystemExit(130) from exc

kon_coding_agent-0.3.3/src/kon/async_utils.py

@@ -0,0 +1,40 @@
+import asyncio
+from contextlib import suppress
+from typing import Any
+
+
+class OperationCancelledError(Exception):
+    pass
+
+
+async def cancel_and_await(task: asyncio.Future[Any]) -> None:
+    if task.done():
+        return
+    task.cancel()
+    with suppress(asyncio.CancelledError):
+        await task
+
+
+async def await_or_cancel[T](work: asyncio.Future[T], cancel_event: asyncio.Event | None) -> T:
+    if not cancel_event:
+        return await work
+
+    if cancel_event.is_set():
+        await cancel_and_await(work)
+        raise OperationCancelledError
+
+    cancel = asyncio.create_task(cancel_event.wait())
+    try:
+        done, pending = await asyncio.wait({work, cancel}, return_when=asyncio.FIRST_COMPLETED)
+
+        for task in pending:
+            await cancel_and_await(task)
+
+        if cancel in done and cancel_event.is_set():
+            if not work.done():
+                await cancel_and_await(work)
+            raise OperationCancelledError
+
+        return work.result()
+    finally:
+        await cancel_and_await(cancel)

kon_coding_agent-0.3.3/src/kon/builtin_skills/init/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: init
+description: Create or update AGENTS.md for this repository
+register_cmd: true
+cmd_info: Guided AGENTS.md setup
+---
+
+Create or update `AGENTS.md` for this repository.
+
+The goal is a compact instruction file that helps future Kon sessions avoid mistakes and ramp up quickly. Every line should answer: "Would an agent likely miss this without help?" If not, leave it out.
+
+User-provided focus or constraints (honor these):
+$ARGUMENTS
+
+## How to investigate
+
+Read the highest-value sources first:
+- `README*`, root manifests, workspace config, lockfiles
+- build, test, lint, formatter, typecheck, and codegen config
+- CI workflows and pre-commit / task runner config
+- existing instruction files (`AGENTS.md`, `CLAUDE.md`, `.cursor/rules/`, `.cursorrules`, `.github/copilot-instructions.md`)
+- repo-local Kon config and conventions
+
+If architecture is still unclear after reading config and docs, inspect a small number of representative code files to find the real entrypoints, package boundaries, and execution flow. Prefer reading the files that explain how the system is wired together over random leaf files.
+
+Prefer executable sources of truth over prose. If docs conflict with config or scripts, trust the executable source and only keep what you can verify.
+
+## What to extract
+
+Look for the highest-signal facts for an agent working in this repo:
+- exact developer commands, especially non-obvious ones
+- how to run a single test, a single package, or a focused verification step
+- required command order when it matters, such as `lint -> typecheck -> test`
+- monorepo or multi-package boundaries, ownership of major directories, and the real app/library entrypoints
+- framework or toolchain quirks: generated code, migrations, codegen, build artifacts, special env loading, dev servers, infra deploy flow
+- repo-specific style or workflow conventions that differ from defaults
+- testing quirks: fixtures, integration test prerequisites, snapshot workflows, required services, flaky or expensive suites
+- important constraints from existing instruction files worth preserving
+
+Good `AGENTS.md` content is usually hard-earned context that took reading multiple files to infer.
+
+## Questions
+
+Only ask the user questions if the repo cannot answer something important. Use the question tool for one short batch at most.
+
+Good questions:
+- undocumented team conventions
+- branch / PR / release expectations
+- missing setup or test prerequisites that are known but not written down
+
+Do not ask about anything the repo already makes clear.
+
+## Writing rules
+
+Include only high-signal, repo-specific guidance such as:
+- exact commands and shortcuts the agent would otherwise guess wrong
+- architecture notes that are not obvious from filenames
+- conventions that differ from language or framework defaults
+- setup requirements, environment quirks, and operational gotchas
+- references to existing instruction sources that matter
+
+Exclude:
+- generic software advice
+- long tutorials or exhaustive file trees
+- obvious language conventions
+- speculative claims or anything you could not verify
+- content better stored in another file referenced via Kon config or another instruction file
+
+When in doubt, omit.
+
+Prefer short sections and bullets. If the repo is simple, keep the file simple. If the repo is large, summarize the few structural facts that actually change how an agent should work.
+
+If `AGENTS.md` already exists, improve it in place rather than rewriting blindly. Preserve verified useful guidance, delete fluff or stale claims, and reconcile it with the current codebase.