klaude-code 1.2.17__py3-none-any.whl → 1.2.18__py3-none-any.whl

klaude_code/trace/__init__.py

@@ -1,3 +1,21 @@
-from .log import DebugType, is_debug_enabled, log, log_debug, logger, prepare_debug_log_file, set_debug_logging
+from .log import (
+    DebugType,
+    get_current_log_file,
+    is_debug_enabled,
+    log,
+    log_debug,
+    logger,
+    prepare_debug_log_file,
+    set_debug_logging,
+)
 
-__all__ = ["DebugType", "is_debug_enabled", "log", "log_debug", "logger", "prepare_debug_log_file", "set_debug_logging"]
+__all__ = [
+    "DebugType",
+    "get_current_log_file",
+    "is_debug_enabled",
+    "log",
+    "log_debug",
+    "logger",
+    "prepare_debug_log_file",
+    "set_debug_logging",
+]

klaude_code/ui/modes/repl/completers.py

@@ -26,6 +26,7 @@ from prompt_toolkit.document import Document
 from prompt_toolkit.formatted_text import HTML
 
 from klaude_code.command import get_commands
+from klaude_code.trace.log import DebugType, log_debug
 
 # Pattern to match @token for completion refresh (used by key bindings).
 # Supports both plain tokens like `@src/file.py` and quoted tokens like
@@ -85,7 +86,7 @@ class _SlashCommandCompleter(Completer):
         matched: list[tuple[str, object, str]] = []
         for cmd_name, cmd_obj in commands.items():
             if cmd_name.startswith(frag):
-                hint = " [instructions]" if cmd_obj.support_addition_params else ""
+                hint = f" [{cmd_obj.placeholder}]" if cmd_obj.support_addition_params else ""
                 matched.append((cmd_name, cmd_obj, hint))
 
         if not matched:
@@ -444,6 +445,8 @@ class _AtFilesCompleter(Completer):
         return items[: min(self._max_results, 100)]
 
     def _run_cmd(self, cmd: list[str], cwd: Path | None = None) -> _CmdResult:
+        cmd_str = " ".join(cmd)
+        start = time.monotonic()
         try:
             p = subprocess.run(
                 cmd,
@@ -453,9 +456,23 @@ class _AtFilesCompleter(Completer):
                 text=True,
                 timeout=1.5,
             )
+            elapsed_ms = (time.monotonic() - start) * 1000
             if p.returncode == 0:
                 lines = [ln.strip() for ln in p.stdout.splitlines() if ln.strip()]
+                log_debug(
+                    f"[completer] cmd={cmd_str} elapsed={elapsed_ms:.1f}ms results={len(lines)}",
+                    debug_type=DebugType.EXECUTION,
+                )
                 return _CmdResult(True, lines)
+            log_debug(
+                f"[completer] cmd={cmd_str} elapsed={elapsed_ms:.1f}ms returncode={p.returncode}",
+                debug_type=DebugType.EXECUTION,
+            )
             return _CmdResult(False, [])
-        except Exception:
+        except Exception as e:
+            elapsed_ms = (time.monotonic() - start) * 1000
+            log_debug(
+                f"[completer] cmd={cmd_str} elapsed={elapsed_ms:.1f}ms error={e!r}",
+                debug_type=DebugType.EXECUTION,
+            )
             return _CmdResult(False, [])

klaude_code/ui/modes/repl/event_handler.py

@@ -9,6 +9,7 @@ from klaude_code import const
 from klaude_code.protocol import events
 from klaude_code.ui.core.stage_manager import Stage, StageManager
 from klaude_code.ui.modes.repl.renderer import REPLRenderer
+from klaude_code.ui.renderers.thinking import normalize_thinking_content
 from klaude_code.ui.rich.markdown import MarkdownStream, ThinkingMarkdown
 from klaude_code.ui.rich.theme import ThemeKey
 from klaude_code.ui.terminal.notifier import Notification, NotificationType, TerminalNotifier
@@ -121,7 +122,7 @@ class ActivityState:
             for name, count in self._tool_calls.items():
                 if not first:
                     activity_text.append(", ")
-                activity_text.append(name)
+                activity_text.append(Text(name, style=ThemeKey.SPINNER_STATUS_TEXT_BOLD))
                 if count > 1:
                     activity_text.append(f" x {count}")
                 first = False
@@ -348,7 +349,7 @@ class DisplayEventHandler:
         self.thinking_stream.append(event.content)
 
         if first_delta and self.thinking_stream.mdstream is not None:
-            self.thinking_stream.mdstream.update(self.thinking_stream.buffer)
+            self.thinking_stream.mdstream.update(normalize_thinking_content(self.thinking_stream.buffer))
 
         await self.stage_manager.enter_thinking_stage()
         self.thinking_stream.debouncer.schedule()
@@ -415,10 +416,11 @@ class DisplayEventHandler:
             self.renderer.display_tool_call(event)
 
     async def _on_tool_result(self, event: events.ToolResultEvent) -> None:
-        if self.renderer.is_sub_agent_session(event.session_id):
+        if self.renderer.is_sub_agent_session(event.session_id) and event.status == "success":
             return
         await self.stage_manager.transition_to(Stage.TOOL_RESULT)
-        self.renderer.display_tool_call_result(event)
+        with self.renderer.session_print_context(event.session_id):
+            self.renderer.display_tool_call_result(event)
 
     def _on_task_metadata(self, event: events.TaskMetadataEvent) -> None:
         self.renderer.display_task_metadata(event)
@@ -498,14 +500,14 @@ class DisplayEventHandler:
         if state.is_active:
             mdstream = state.mdstream
             assert mdstream is not None
-            mdstream.update(state.buffer)
+            mdstream.update(normalize_thinking_content(state.buffer))
 
     async def _finish_thinking_stream(self) -> None:
         if self.thinking_stream.is_active:
             self.thinking_stream.debouncer.cancel()
             mdstream = self.thinking_stream.mdstream
             assert mdstream is not None
-            mdstream.update(self.thinking_stream.buffer, final=True)
+            mdstream.update(normalize_thinking_content(self.thinking_stream.buffer), final=True)
             self.thinking_stream.finish()
             self.renderer.console.pop_theme()
             self.renderer.print()

klaude_code/ui/renderers/metadata.py

@@ -61,9 +61,7 @@ def _render_task_metadata_block(
     if metadata.usage is not None:
         # Tokens: ↑ 37k cache 5k ↓ 907 think 45k
         token_parts: list[Text] = [
-            Text.assemble(
-                ("↑ ", ThemeKey.METADATA_DIM), (format_number(metadata.usage.input_tokens), ThemeKey.METADATA)
-            )
+            Text.assemble(("↑", ThemeKey.METADATA_DIM), (format_number(metadata.usage.input_tokens), ThemeKey.METADATA))
         ]
         if metadata.usage.cached_tokens > 0:
             token_parts.append(
@@ -74,7 +72,7 @@ def _render_task_metadata_block(
             )
         token_parts.append(
             Text.assemble(
-                ("↓ ", ThemeKey.METADATA_DIM), (format_number(metadata.usage.output_tokens), ThemeKey.METADATA)
+                ("↓", ThemeKey.METADATA_DIM), (format_number(metadata.usage.output_tokens), ThemeKey.METADATA)
             )
         )
         if metadata.usage.reasoning_tokens > 0:

klaude_code/ui/renderers/thinking.py

@@ -1,3 +1,5 @@
+import re
+
 from rich.console import RenderableType
 from rich.padding import Padding
 from rich.text import Text
@@ -10,14 +12,28 @@ def thinking_prefix() -> Text:
     return Text.from_markup("[not italic]⸫[/not italic] Thinking …", style=ThemeKey.THINKING)
 
 
-def _normalize_thinking_content(content: str) -> str:
+def normalize_thinking_content(content: str) -> str:
     """Normalize thinking content for display."""
-    return (
-        content.rstrip()
-        .replace("**\n\n", "**  \n")
-        .replace("\\n\\n\n\n", "")  # Weird case of Gemini 3
-        .replace("****", "**\n\n**")  # Remove extra newlines after bold titles
-    )
+    text = content.rstrip()
+
+    # Weird case of Gemini 3
+    text = text.replace("\\n\\n\n\n", "")
+
+    # Fix OpenRouter OpenAI reasoning formatting where segments like
+    # "text**Title**\n\n" lose the blank line between segments.
+    # We want: "text\n**Title**\n" so that each bold title starts on
+    # its own line and uses a single trailing newline.
+    text = re.sub(r"([^\n])(\*\*[^*]+?\*\*)\n\n", r"\1  \n\n\2  \n", text)
+
+    # Remove extra newlines between back-to-back bold titles, eg
+    # "**Title1****Title2**" -> "**Title1**\n\n**Title2**".
+    text = text.replace("****", "**\n\n**")
+
+    # Compact double-newline after bold so the body text follows
+    # directly after the title line, using a markdown line break.
+    text = text.replace("**\n\n", "**  \n")
+
+    return text
 
 
 def render_thinking(content: str, *, code_theme: str, style: str) -> RenderableType | None:
@@ -31,7 +47,7 @@ def render_thinking(content: str, *, code_theme: str, style: str) -> RenderableT
 
     return Padding.indent(
         ThinkingMarkdown(
-            _normalize_thinking_content(content),
+            normalize_thinking_content(content),
             code_theme=code_theme,
             style=style,
         ),

klaude_code/ui/renderers/tools.py

@@ -2,7 +2,7 @@ import json
 from pathlib import Path
 from typing import Any, cast
 
-from rich.console import RenderableType
+from rich.console import Group, RenderableType
 from rich.padding import Padding
 from rich.text import Text
 
@@ -379,6 +379,75 @@ def render_mermaid_tool_call(arguments: str) -> RenderableType:
     return grid
 
 
+def _truncate_url(url: str, max_length: int = 400) -> str:
+    """Truncate URL for display, preserving domain and path structure."""
+    if len(url) <= max_length:
+        return url
+    # Remove protocol for display
+    display_url = url
+    for prefix in ("https://", "http://"):
+        if display_url.startswith(prefix):
+            display_url = display_url[len(prefix) :]
+            break
+    if len(display_url) <= max_length:
+        return display_url
+    # Truncate with ellipsis
+    return display_url[: max_length - 3] + "..."
+
+
+def render_web_fetch_tool_call(arguments: str) -> RenderableType:
+    grid = create_grid()
+    tool_name_column = Text.assemble(("↓", ThemeKey.TOOL_MARK), " ", ("Fetch", ThemeKey.TOOL_NAME))
+
+    try:
+        payload: dict[str, str] = json.loads(arguments)
+    except json.JSONDecodeError:
+        summary = Text(
+            arguments.strip()[: const.INVALID_TOOL_CALL_MAX_LENGTH],
+            style=ThemeKey.INVALID_TOOL_CALL_ARGS,
+        )
+        grid.add_row(tool_name_column, summary)
+        return grid
+
+    url = payload.get("url", "")
+    summary = Text(_truncate_url(url), ThemeKey.TOOL_PARAM_FILE_PATH) if url else Text("(no url)", ThemeKey.TOOL_PARAM)
+
+    grid.add_row(tool_name_column, summary)
+    return grid
+
+
+def render_web_search_tool_call(arguments: str) -> RenderableType:
+    grid = create_grid()
+    tool_name_column = Text.assemble(("◉", ThemeKey.TOOL_MARK), " ", ("Search", ThemeKey.TOOL_NAME))
+
+    try:
+        payload: dict[str, Any] = json.loads(arguments)
+    except json.JSONDecodeError:
+        summary = Text(
+            arguments.strip()[: const.INVALID_TOOL_CALL_MAX_LENGTH],
+            style=ThemeKey.INVALID_TOOL_CALL_ARGS,
+        )
+        grid.add_row(tool_name_column, summary)
+        return grid
+
+    query = payload.get("query", "")
+    max_results = payload.get("max_results")
+
+    summary = Text("", ThemeKey.TOOL_PARAM)
+    if query:
+        # Truncate long queries
+        display_query = query if len(query) <= 80 else query[:77] + "..."
+        summary.append(display_query, ThemeKey.TOOL_PARAM)
+    else:
+        summary.append("(no query)", ThemeKey.TOOL_PARAM)
+
+    if isinstance(max_results, int) and max_results != 10:
+        summary.append(f" (max {max_results})", ThemeKey.TOOL_TIMEOUT)
+
+    grid.add_row(tool_name_column, summary)
+    return grid
+
+
 def render_mermaid_tool_result(tr: events.ToolResultEvent) -> RenderableType:
     from klaude_code.ui.terminal import supports_osc8_hyperlinks
 
@@ -409,16 +478,12 @@ def _extract_truncation(
 
 def render_truncation_info(ui_extra: model.TruncationUIExtra) -> RenderableType:
     """Render truncation info for the user."""
-    original_kb = ui_extra.original_length / 1024
     truncated_kb = ui_extra.truncated_length / 1024
+
     text = Text.assemble(
-        ("Output truncated: ", ThemeKey.TOOL_RESULT),
-        (f"{original_kb:.1f}KB", ThemeKey.TOOL_RESULT),
-        (" total, ", ThemeKey.TOOL_RESULT),
-        (f"{truncated_kb:.1f}KB", ThemeKey.TOOL_RESULT_BOLD),
-        (" hidden\nFull output saved to ", ThemeKey.TOOL_RESULT),
-        (ui_extra.saved_file_path, ThemeKey.TOOL_RESULT),
-        ("\nUse Read with limit+offset or rg/grep to inspect", ThemeKey.TOOL_RESULT),
+        ("Offload context to ", ThemeKey.TOOL_RESULT_TRUNCATED),
+        (ui_extra.saved_file_path, ThemeKey.TOOL_RESULT_TRUNCATED),
+        (f", {truncated_kb:.1f}KB truncated", ThemeKey.TOOL_RESULT_TRUNCATED),
     )
     return Padding.indent(text, level=2)
 
@@ -506,6 +571,10 @@ def render_tool_call(e: events.ToolCallEvent) -> RenderableType | None:
             return render_generic_tool_call(e.tool_name, e.arguments, "◈")
         case tools.REPORT_BACK:
             return render_report_back_tool_call()
+        case tools.WEB_FETCH:
+            return render_web_fetch_tool_call(e.arguments)
+        case tools.WEB_SEARCH:
+            return render_web_search_tool_call(e.arguments)
         case _:
             return render_generic_tool_call(e.tool_name, e.arguments)
 
@@ -534,7 +603,7 @@ def render_tool_result(e: events.ToolResultEvent) -> RenderableType | None:
     # Show truncation info if output was truncated and saved to file
     truncation_info = get_truncation_info(e)
     if truncation_info:
-        return render_truncation_info(truncation_info)
+        return Group(render_truncation_info(truncation_info), render_generic_tool_result(e.result))
 
     diff_text = _extract_diff_text(e.ui_extra)
 

klaude_code/ui/rich/code_panel.py

@@ -0,0 +1,112 @@
+"""A panel that only has top and bottom borders, no left/right borders or padding."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from rich.console import ConsoleRenderable, RichCast
+from rich.jupyter import JupyterMixin
+from rich.measure import Measurement, measure_renderables
+from rich.segment import Segment
+from rich.style import StyleType
+
+if TYPE_CHECKING:
+    from rich.console import Console, ConsoleOptions, RenderResult
+
+# Box drawing characters
+TOP_LEFT = "┌"  # ┌
+TOP_RIGHT = "┐"  # ┐
+BOTTOM_LEFT = "└"  # └
+BOTTOM_RIGHT = "┘"  # ┘
+HORIZONTAL = "─"  # ─
+
+
+class CodePanel(JupyterMixin):
+    """A panel with only top and bottom borders, no left/right borders.
+
+    This is designed for code blocks where you want easy copy-paste without
+    picking up border characters on the sides.
+
+    Example:
+        >>> console.print(CodePanel(Syntax(code, "python")))
+
+    Renders as:
+        ┌──────────────────────────┐
+        code line 1
+        code line 2
+        └──────────────────────────┘
+    """
+
+    def __init__(
+        self,
+        renderable: ConsoleRenderable | RichCast | str,
+        *,
+        border_style: StyleType = "none",
+        expand: bool = False,
+        padding: int = 1,
+    ) -> None:
+        """Initialize the CodePanel.
+
+        Args:
+            renderable: A console renderable object.
+            border_style: The style of the border. Defaults to "none".
+            expand: If True, expand to fill available width. Defaults to False.
+            padding: Left/right padding for content. Defaults to 1.
+        """
+        self.renderable = renderable
+        self.border_style = border_style
+        self.expand = expand
+        self.padding = padding
+
+    def __rich_console__(self, console: Console, options: ConsoleOptions) -> RenderResult:
+        border_style = console.get_style(self.border_style)
+        max_width = options.max_width
+        pad = self.padding
+
+        # Measure the content width (account for padding)
+        if self.expand:
+            content_width = max_width - pad * 2
+        else:
+            content_width = console.measure(self.renderable, options=options.update(width=max_width - pad * 2)).maximum
+            content_width = min(content_width, max_width - pad * 2)
+
+        # Render content lines
+        child_options = options.update(width=content_width)
+        lines = console.render_lines(self.renderable, child_options)
+
+        # Calculate border width based on content width + padding
+        border_width = content_width + pad * 2
+
+        new_line = Segment.line()
+        pad_segment = Segment(" " * pad) if pad > 0 else None
+
+        # Top border: ┌───...───┐
+        top_border = (
+            TOP_LEFT + (HORIZONTAL * (border_width - 2)) + TOP_RIGHT if border_width >= 2 else HORIZONTAL * border_width
+        )
+        yield Segment(top_border, border_style)
+        yield new_line
+
+        # Content lines with padding
+        for line in lines:
+            if pad_segment:
+                yield pad_segment
+            yield from line
+            if pad_segment:
+                yield pad_segment
+            yield new_line
+
+        # Bottom border: └───...───┘
+        bottom_border = (
+            BOTTOM_LEFT + (HORIZONTAL * (border_width - 2)) + BOTTOM_RIGHT
+            if border_width >= 2
+            else HORIZONTAL * border_width
+        )
+        yield Segment(bottom_border, border_style)
+        yield new_line
+
+    def __rich_measure__(self, console: Console, options: ConsoleOptions) -> Measurement:
+        if self.expand:
+            return Measurement(options.max_width, options.max_width)
+        width = measure_renderables(console, options, [self.renderable]).maximum + self.padding * 2
+        return Measurement(width, width)

klaude_code/ui/rich/markdown.py

@@ -7,11 +7,9 @@ import time
 from collections.abc import Callable
 from typing import Any, ClassVar
 
-from rich import box
 from rich.console import Console, ConsoleOptions, Group, RenderableType, RenderResult
 from rich.live import Live
 from rich.markdown import CodeBlock, Heading, Markdown
-from rich.panel import Panel
 from rich.rule import Rule
 from rich.spinner import Spinner
 from rich.style import Style
@@ -20,6 +18,7 @@ from rich.text import Text
 from rich.theme import Theme
 
 from klaude_code import const
+from klaude_code.ui.rich.code_panel import CodePanel
 
 
 class NoInsetCodeBlock(CodeBlock):
@@ -34,7 +33,7 @@ class NoInsetCodeBlock(CodeBlock):
             word_wrap=True,
             padding=(0, 0),
         )
-        yield Panel.fit(syntax, padding=(0, 0), box=box.HORIZONTALS, border_style="markdown.code.border")
+        yield CodePanel(syntax, border_style="markdown.code.border")
 
 
 class ThinkingCodeBlock(CodeBlock):
@@ -43,7 +42,7 @@ class ThinkingCodeBlock(CodeBlock):
     def __rich_console__(self, console: Console, options: ConsoleOptions) -> RenderResult:
         code = str(self.text).rstrip()
         text = Text(code, "markdown.code.block")
-        yield text
+        yield CodePanel(text, border_style="markdown.code.border")
 
 
 class LeftHeading(Heading):

klaude_code/ui/rich/status.py

@@ -35,8 +35,6 @@ _BREATHING_SPINNER_GLYPHS_BASE = [
     "✴",
     "✷",
     "⟡",
-    "⬡",
-    "⬢",
 ]
 
 # Shuffle glyphs on module load for variety across sessions

klaude_code/ui/rich/theme.py

@@ -86,6 +86,7 @@ class ThemeKey(str, Enum):
     # SPINNER_STATUS
     SPINNER_STATUS = "spinner.status"
     SPINNER_STATUS_TEXT = "spinner.status.text"
+    SPINNER_STATUS_TEXT_BOLD = "spinner.status.text.bold"
     # STATUS
     STATUS_HINT = "status.hint"
     # USER_INPUT
@@ -103,6 +104,7 @@ class ThemeKey(str, Enum):
     TOOL_PARAM = "tool.param"
     TOOL_PARAM_BOLD = "tool.param.bold"
     TOOL_RESULT = "tool.result"
+    TOOL_RESULT_TRUNCATED = "tool.result.truncated"
     TOOL_RESULT_BOLD = "tool.result.bold"
     TOOL_MARK = "tool.mark"
     TOOL_APPROVED = "tool.approved"
@@ -181,6 +183,7 @@ def get_theme(theme: str | None = None) -> Themes:
                 # SPINNER_STATUS
                 ThemeKey.SPINNER_STATUS.value: palette.blue,
                 ThemeKey.SPINNER_STATUS_TEXT.value: palette.blue,
+                ThemeKey.SPINNER_STATUS_TEXT_BOLD.value: "bold " + palette.blue,
                 # STATUS
                 ThemeKey.STATUS_HINT.value: palette.grey2,
                 # REMINDER
@@ -194,6 +197,7 @@ def get_theme(theme: str | None = None) -> Themes:
                 ThemeKey.TOOL_PARAM_BOLD.value: "bold " + palette.green,
                 ThemeKey.TOOL_RESULT.value: palette.grey_green,
                 ThemeKey.TOOL_RESULT_BOLD.value: "bold " + palette.grey_green,
+                ThemeKey.TOOL_RESULT_TRUNCATED.value: palette.yellow,
                 ThemeKey.TOOL_MARK.value: "bold",
                 ThemeKey.TOOL_APPROVED.value: palette.green + " bold reverse",
                 ThemeKey.TOOL_REJECTED.value: palette.red + " bold reverse",
@@ -243,11 +247,15 @@ def get_theme(theme: str | None = None) -> Themes:
                 "markdown.hr": palette.grey3,
                 "markdown.item.bullet": palette.grey2,
                 "markdown.item.number": palette.grey2,
+                "markdown.link": "underline " + palette.blue,
+                "markdown.link_url": "underline " + palette.blue,
             }
         ),
         thinking_markdown_theme=Theme(
             styles={
                 "markdown.code": palette.grey1 + " italic on " + palette.text_background,
+                "markdown.code.block": palette.grey1,
+                "markdown.code.border": palette.grey3,
                 "markdown.h1": "bold reverse",
                 "markdown.h1.border": palette.grey3,
                 "markdown.h2.border": palette.grey3,
@@ -256,7 +264,8 @@ def get_theme(theme: str | None = None) -> Themes:
                 "markdown.hr": palette.grey3,
                 "markdown.item.bullet": palette.grey2,
                 "markdown.item.number": palette.grey2,
-                "markdown.code.block": palette.grey1,
+                "markdown.link": "underline " + palette.blue,
+                "markdown.link_url": "underline " + palette.blue,
                 "markdown.strong": "bold italic " + palette.grey1,
             }
         ),

{klaude_code-1.2.17.dist-info → klaude_code-1.2.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: klaude-code
-Version: 1.2.17
+Version: 1.2.18
 Summary: Add your description here
 Requires-Dist: anthropic>=0.66.0
 Requires-Dist: ddgs>=9.9.3
@@ -51,12 +51,17 @@ klaude [--model <name>] [--select-model]
 
 **Options:**
 - `--version`/`-V`: Show version and exit.
-- `--model`/`-m`: Select a model by logical name from config.
-- `--select-model`/`-s`: Interactively choose a model at startup.
+- `--model`/`-m`: Preferred model name (exact match picks immediately; otherwise opens the interactive selector filtered by this value).
+- `--select-model`/`-s`: Open the interactive model selector at startup (shows all models unless `--model` is also provided).
 - `--continue`/`-c`: Resume the most recent session.
 - `--resume`/`-r`: Select a session to resume for this project.
 - `--vanilla`: Minimal mode with only basic tools (Bash, Read, Edit) and no system prompts.
 
+**Model selection behavior:**
+- Default: uses `main_model` from config.
+- `--select-model`: always prompts you to pick.
+- `--model <value>`: tries to resolve `<value>` to a single model; if it can't, it prompts with a filtered list (and falls back to showing all models if there are no matches).
+
 **Debug Options:**
 - `--debug`/`-d`: Enable debug mode with verbose logging and LLM trace.
 - `--debug-filter`: Filter debug output by type (comma-separated).
@@ -64,7 +69,7 @@ klaude [--model <name>] [--select-model]
 
 ### Configuration
 
-An example config will be created in `~/.klaude/config.yaml` when first run.
+An example config will be created in `~/.klaude/klaude-config.yaml` when first run.
 
 Open the configuration file in editor:
 
@@ -201,7 +206,7 @@ sub_agent_models:
   oracle: gpt-5.1
   explore: haiku
   task: opus
-  webfetchagent: haiku
+  webagent: haiku
 
 ```
 
@@ -263,5 +268,10 @@ klaude exec "what is 2+2?"
 echo "hello world" | klaude exec
 
 # With model selection
+
+# Exact model name (non-interactive)
 echo "generate quicksort in python" | klaude exec --model gpt-5.1
-```
+
+# Partial/ambiguous name opens the interactive selector (filtered)
+echo "generate quicksort in python" | klaude exec --model gpt
+```