deepy-cli 0.2.18__tar.gz → 0.2.19__tar.gz

{deepy_cli-0.2.18 → deepy_cli-0.2.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deepy-cli
-Version: 0.2.18
+Version: 0.2.19
 Summary: Deepy - Vibe coding for DeepSeek models in your terminal
 Keywords: deepseek,coding-agent,terminal,cli,agents
 Author: kirineko
@@ -43,7 +43,9 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
-  <a href="https://kirineko.github.io/deepy/">Website</a>
+  <a href="https://deepy.kirineko.tech/"><strong>Install Website</strong></a>
+  ·
+  <a href="https://kirineko.github.io/deepy/">GitHub Pages</a>
   ·
   <a href="README.zh-CN.md">中文文档</a>
   ·
@@ -54,6 +56,8 @@ Description-Content-Type: text/markdown
 
 ![Deepy terminal welcome screen](https://raw.githubusercontent.com/kirineko/deepy/main/asset/welcome.webp)
 
+> Install and setup guide: **https://deepy.kirineko.tech/**
+
 ## What Deepy Does
 
 Deepy is a Python CLI coding agent for DeepSeek and supported
@@ -113,6 +117,8 @@ for direct local commands.
 
 ## Quick Start
 
+For the guided installation page, open **https://deepy.kirineko.tech/**.
+
 1. Install `uv`:
 
 ```bash

{deepy_cli-0.2.18 → deepy_cli-0.2.19}/README.md

@@ -11,7 +11,9 @@
 </p>
 
 <p align="center">
-  <a href="https://kirineko.github.io/deepy/">Website</a>
+  <a href="https://deepy.kirineko.tech/"><strong>Install Website</strong></a>
+  ·
+  <a href="https://kirineko.github.io/deepy/">GitHub Pages</a>
   ·
   <a href="README.zh-CN.md">中文文档</a>
   ·
@@ -22,6 +24,8 @@
 
 ![Deepy terminal welcome screen](https://raw.githubusercontent.com/kirineko/deepy/main/asset/welcome.webp)
 
+> Install and setup guide: **https://deepy.kirineko.tech/**
+
 ## What Deepy Does
 
 Deepy is a Python CLI coding agent for DeepSeek and supported
@@ -81,6 +85,8 @@ for direct local commands.
 
 ## Quick Start
 
+For the guided installation page, open **https://deepy.kirineko.tech/**.
+
 1. Install `uv`:
 
 ```bash

{deepy_cli-0.2.18 → deepy_cli-0.2.19}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepy-cli"
-version = "0.2.18"
+version = "0.2.19"
 description = "Deepy - Vibe coding for DeepSeek models in your terminal"
 readme = "README.md"
 authors = [

{deepy_cli-0.2.18 → deepy_cli-0.2.19}/src/deepy/__init__.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-__version__ = "0.2.18"
+__version__ = "0.2.19"
 
 
 def main() -> None:

{deepy_cli-0.2.18 → deepy_cli-0.2.19}/src/deepy/sessions/jsonl.py

@@ -143,7 +143,6 @@ class DeepyJsonlSession:
         state = self.context_token_state(records)
         self._touch_index(
             active_tokens=state.active_tokens,
-            latest_context_window_tokens=state.active_tokens,
             last_usage_tokens=state.last_usage_tokens,
             pending_tokens=state.pending_tokens,
             last_usage_record_count=state.last_usage_record_count,

{deepy_cli-0.2.18 → deepy_cli-0.2.19}/src/deepy/tui/commands.py

@@ -6,6 +6,8 @@ from typing import TYPE_CHECKING
 
 from textual.command import DiscoveryHit, Hit, Hits, Provider
 
+from deepy.ui.slash_commands import slash_command_priority
+
 if TYPE_CHECKING:
     from deepy.tui.app import DeepyTuiApp
 
@@ -59,24 +61,34 @@ def command_by_name(name: str) -> TuiCommand | None:
     return next((command for command in TUI_COMMANDS if command.name == name), None)
 
 
+def ranked_tui_commands() -> list[TuiCommand]:
+    return sorted(TUI_COMMANDS, key=lambda command: (slash_command_priority(command.name), command.name))
+
+
 class DeepyCommandProvider(Provider):
     async def search(self, query: str) -> Hits:
         matcher = self.matcher(query)
         app = self.app
-        for command in TUI_COMMANDS:
+        matches = []
+        for command in ranked_tui_commands():
             candidate = f"{command.label} {command.description} {command.group}"
             score = matcher.match(candidate)
             if score > 0:
-                yield Hit(
-                    score,
-                    matcher.highlight(command.label),
-                    partial(app.invoke_tui_command, command.name),
-                    help=f"{command.group}: {command.description}",
-                )
+                matches.append((score, command))
+        for score, command in sorted(
+            matches,
+            key=lambda item: (-item[0], slash_command_priority(item[1].name), item[1].name),
+        ):
+            yield Hit(
+                score,
+                matcher.highlight(command.label),
+                partial(app.invoke_tui_command, command.name),
+                help=f"{command.group}: {command.description}",
+            )
 
     async def discover(self) -> Hits:
         app = self.app
-        for command in TUI_COMMANDS:
+        for command in ranked_tui_commands():
             yield DiscoveryHit(
                 command.label,
                 partial(app.invoke_tui_command, command.name),

{deepy_cli-0.2.18 → deepy_cli-0.2.19}/src/deepy/tui/widgets.py

@@ -35,7 +35,7 @@ from deepy.ui.message_view import (
 from deepy.ui.slash_commands import (
     SlashCommandItem,
     filter_slash_commands,
-    format_slash_command_label,
+    format_slash_command_completion_label,
 )
 
 
@@ -244,7 +244,7 @@ class PromptPanel(Vertical):
             self._refresh_input_suggestion_display()
             return
         option_list.display = True
-        option_list.add_options([Option(suggestion, id=suggestion) for suggestion in suggestions[:8]])
+        option_list.add_options([Option(suggestion, id=suggestion) for suggestion in suggestions])
         option_list.highlighted = 0
         self._refresh_input_suggestion_display()
 
@@ -308,10 +308,14 @@ class PromptPanel(Vertical):
             and token == text
             and not any(char.isspace() for char in token)
         ):
-            if any(item.label == token for item in self.slash_commands):
+            if any(
+                item.label == token
+                or (item.kind == "skill" and f"/skill:{item.name}" == token)
+                for item in self.slash_commands
+            ):
                 return []
             return [
-                f"{format_slash_command_label(item)}  {item.description}"
+                f"{format_slash_command_completion_label(item, token)}  {item.description}"
                 for item in filter_slash_commands(self.slash_commands, token)
             ]
         mention = extract_file_mention_fragment(text)

{deepy_cli-0.2.18 → deepy_cli-0.2.19}/src/deepy/ui/prompt_input.py

@@ -7,7 +7,7 @@ from unicodedata import normalize
 
 from prompt_toolkit import PromptSession
 from prompt_toolkit.auto_suggest import AutoSuggest, Suggestion
-from prompt_toolkit.completion import Completer, CompleteEvent, WordCompleter, merge_completers
+from prompt_toolkit.completion import Completer, CompleteEvent, Completion, merge_completers
 from prompt_toolkit.document import Document
 from prompt_toolkit.formatted_text import AnyFormattedText, StyleAndTextTuples
 from prompt_toolkit.history import FileHistory
@@ -18,7 +18,13 @@ from deepy.input_suggestions import InputSuggestionController
 from deepy.skills import SkillInfo
 from deepy.ui.file_mentions import FileMentionCompleter
 from deepy.ui.prompt_buffer import PromptBufferState
-from deepy.ui.slash_commands import SlashCommandItem
+from deepy.ui.slash_commands import (
+    SlashCommandItem,
+    find_exact_slash_command,
+    format_slash_command_completion_label,
+    format_slash_command_description,
+    rank_slash_commands,
+)
 from deepy.ui.status_footer import StatusFooter
 from deepy.ui.styles import DARK_PALETTE, UiPalette
 
@@ -52,11 +58,10 @@ def create_prompt_session(
     path = history_path or DEFAULT_PROMPT_HISTORY
     path.parent.mkdir(parents=True, exist_ok=True)
     path.touch(exist_ok=True)
-    labels = [item.label for item in slash_commands or []]
     root = project_root or Path.cwd()
     completer = merge_completers(
         [
-            WordCompleter(labels, ignore_case=True, sentence=True),
+            SlashCommandCompleter(slash_commands or []),
             FileMentionCompleter(root),
         ],
         deduplicate=True,
@@ -109,6 +114,38 @@ class InputSuggestionAwareCompleter(Completer):
         yield from self.completer.get_completions(document, complete_event)
 
 
+class SlashCommandCompleter(Completer):
+    def __init__(self, slash_commands: list[SlashCommandItem]) -> None:
+        self.slash_commands = slash_commands
+
+    def get_completions(self, document: Document, complete_event: CompleteEvent):
+        del complete_event
+        token = _slash_token_before_cursor(document)
+        if token is None:
+            return
+        if find_exact_slash_command(self.slash_commands, token) is not None:
+            return
+        for item in rank_slash_commands(self.slash_commands, token):
+            label = format_slash_command_completion_label(item, token)
+            yield Completion(
+                label.removesuffix(" *"),
+                start_position=-len(token),
+                display=label,
+                display_meta=format_slash_command_description(item.description),
+            )
+
+
+def _slash_token_before_cursor(document: Document) -> str | None:
+    before = document.text_before_cursor
+    start = len(before)
+    while start > 0 and not before[start - 1].isspace():
+        start -= 1
+    token = before[start:]
+    if not token.startswith("/") or not token:
+        return None
+    return token
+
+
 def build_prompt_key_bindings(
     *,
     on_interrupt: Callable[[], None] | None = None,

{deepy_cli-0.2.18 → deepy_cli-0.2.19}/src/deepy/ui/slash_commands.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import re
 from dataclasses import dataclass, replace
+from enum import IntEnum
 
 from deepy.skills import SkillInfo
 from deepy.subagents import built_in_subagents
@@ -44,6 +45,36 @@ SUBAGENT_SLASH_COMMANDS = tuple(
 )
 BUILTIN_SLASH_COMMAND_NAMES = frozenset(item.name for item in BUILTIN_SLASH_COMMANDS)
 SUBAGENT_SLASH_COMMAND_NAMES = frozenset(item.name for item in SUBAGENT_SLASH_COMMANDS)
+COMMON_WORKFLOW_COMMAND_ORDER = {
+    "help": 0,
+    "new": 1,
+    "resume": 2,
+    "model": 3,
+    "skills": 4,
+    "status": 5,
+    "compact": 6,
+    "mcp": 7,
+    "exit": 8,
+}
+LOW_FREQUENCY_COMMAND_ORDER = {
+    "init": 0,
+    "theme": 1,
+    "input-suggestion": 2,
+    "ps": 3,
+    "stop": 4,
+    "reset": 5,
+}
+SKILL_SCOPE_PRIORITY = {
+    "project": 0,
+    "user": 1,
+    "builtin": 2,
+}
+
+
+class SlashCommandMatch(IntEnum):
+    EXACT = 0
+    PREFIX = 1
+    WEAK = 2
 
 
 def build_slash_commands(
@@ -65,16 +96,79 @@ def build_slash_commands(
 
 
 def filter_slash_commands(items: list[SlashCommandItem], token: str) -> list[SlashCommandItem]:
+    return rank_slash_commands(items, token)
+
+
+def rank_slash_commands(items: list[SlashCommandItem], token: str) -> list[SlashCommandItem]:
     if not token.startswith("/"):
         return []
     query = token[1:].lower()
     if not query:
-        return items
-    return [
-        item
+        return sorted(items, key=slash_command_sort_key)
+    scored = [
+        (match, slash_command_sort_key(item), item)
         for item in items
-        if item.name.lower().startswith(query) or item.label[1:].lower().startswith(query)
+        if (match := slash_command_match(item, query)) is not None
     ]
+    scored.sort(key=lambda scored_item: (scored_item[0], scored_item[1]))
+    return [item for _match, _sort_key, item in scored]
+
+
+def slash_command_match(item: SlashCommandItem, query: str) -> SlashCommandMatch | None:
+    normalized = query.lower()
+    name = item.name.lower()
+    label = item.label[1:].lower()
+    description = item.description.lower()
+    legacy_skill_name = f"skill:{name}" if item.kind == "skill" else ""
+    values = [name, label]
+    if legacy_skill_name:
+        values.append(legacy_skill_name)
+    if any(value == normalized for value in values):
+        return SlashCommandMatch.EXACT
+    if any(value.startswith(normalized) for value in values):
+        return SlashCommandMatch.PREFIX
+    if normalized in name or normalized in label or normalized in description:
+        return SlashCommandMatch.WEAK
+    return None
+
+
+def slash_command_sort_key(item: SlashCommandItem) -> tuple[int, int, int, str]:
+    return (
+        slash_command_priority(item),
+        slash_command_loaded_priority(item),
+        slash_command_scope_priority(item),
+        item.name.lower(),
+    )
+
+
+def slash_command_priority(item: SlashCommandItem | str) -> int:
+    if isinstance(item, str):
+        name = item
+        kind = "builtin"
+    else:
+        name = item.name
+        kind = item.kind
+    if name in COMMON_WORKFLOW_COMMAND_ORDER:
+        return COMMON_WORKFLOW_COMMAND_ORDER[name]
+    if kind == "subagent":
+        return 100
+    if kind == "skill":
+        return 200
+    if name in LOW_FREQUENCY_COMMAND_ORDER:
+        return 300 + LOW_FREQUENCY_COMMAND_ORDER[name]
+    return 250
+
+
+def slash_command_loaded_priority(item: SlashCommandItem) -> int:
+    if item.kind == "skill" and item.skill and item.skill.is_loaded:
+        return 0
+    return 1
+
+
+def slash_command_scope_priority(item: SlashCommandItem) -> int:
+    if item.kind != "skill" or item.skill is None:
+        return 0
+    return SKILL_SCOPE_PRIORITY.get(item.skill.scope, 3)
 
 
 def find_exact_slash_command(
@@ -102,6 +196,14 @@ def format_slash_command_label(item: SlashCommandItem) -> str:
     return f"{item.label} *" if item.kind == "skill" and loaded else item.label
 
 
+def format_slash_command_completion_label(item: SlashCommandItem, token: str = "") -> str:
+    label = item.label
+    if item.kind == "skill" and token[1:].lower().startswith("skill:"):
+        label = f"/skill:{item.name}"
+    loaded = bool(item.skill and item.skill.is_loaded)
+    return f"{label} *" if item.kind == "skill" and loaded else label
+
+
 def is_builtin_slash_command(name: str) -> bool:
     return name in BUILTIN_SLASH_COMMAND_NAMES
 

{deepy_cli-0.2.18 → deepy_cli-0.2.19}/src/deepy/ui/terminal.py

@@ -2819,6 +2819,13 @@ class _SilentStatus:
         return None
 
 
+@dataclass(frozen=True)
+class _RuntimeStatusSegments:
+    prefix: str
+    label: str = ""
+    payload: str = ""
+
+
 def _terminal_runtime_status_style(palette: UiPalette) -> str:
     foreground = _hex_color(palette.toolbar_background) or "#161821"
     background = _hex_color(palette.warning) or "#facc15"
@@ -2851,6 +2858,18 @@ def _ansi_rgb(prefix: str, color: str) -> str:
     return f"{prefix};2;{red};{green};{blue}"
 
 
+_ANSI_ESCAPE_RE = re.compile(r"\x1b\[[0-?]*[ -/]*[@-~]")
+_CONTROL_CHAR_RE = re.compile(r"[\x00-\x08\x0b\x0c\x0e-\x1f\x7f-\x9f]")
+_STATUS_SEPARATOR = " · "
+
+
+def _sanitize_status_line(text: str) -> str:
+    stripped = _ANSI_ESCAPE_RE.sub("", text)
+    stripped = stripped.replace("\r", " ").replace("\n", " ").replace("\t", " ")
+    stripped = _CONTROL_CHAR_RE.sub("", stripped)
+    return re.sub(r" {2,}", " ", stripped).strip()
+
+
 def _truncate_status_line(text: str, *, max_width: int) -> str:
     if cell_len(text) <= max_width:
         return text
@@ -2870,10 +2889,88 @@ def _truncate_status_line(text: str, *, max_width: int) -> str:
 
 
 def _fit_status_line(text: str, *, width: int) -> str:
-    line = _truncate_status_line(text, max_width=max(width, 0))
+    width = max(width, 0)
+    sanitized = _sanitize_status_line(text)
+    segments = _parse_runtime_status_segments(sanitized)
+    line = (
+        _fit_runtime_status_segments(segments, width=width)
+        if segments is not None
+        else _truncate_status_line(sanitized, max_width=width)
+    )
     return line + (" " * max(0, width - cell_len(line)))
 
 
+def _parse_runtime_status_segments(text: str) -> _RuntimeStatusSegments | None:
+    interrupt = "esc to interrupt"
+    interrupt_index = text.find(interrupt)
+    if interrupt_index < 0:
+        return None
+
+    prefix_end = interrupt_index + len(interrupt)
+    prefix = text[:prefix_end].strip()
+    detail = text[prefix_end:]
+    if detail.startswith(_STATUS_SEPARATOR):
+        detail = detail[len(_STATUS_SEPARATOR) :].strip()
+    else:
+        detail = detail.strip()
+    if not detail:
+        return _RuntimeStatusSegments(prefix=prefix)
+
+    if detail.startswith(f"local command{_STATUS_SEPARATOR}"):
+        payload = detail.removeprefix(f"local command{_STATUS_SEPARATOR}").strip()
+        return _RuntimeStatusSegments(prefix=prefix, label="local command", payload=payload)
+
+    tool_match = re.match(r"(tool \[[^\]]+\])(?:\s+(.*))?$", detail)
+    if tool_match:
+        label, payload = tool_match.groups()
+        return _RuntimeStatusSegments(prefix=prefix, label=label, payload=(payload or "").strip())
+
+    return _RuntimeStatusSegments(prefix=prefix, label=detail)
+
+
+def _fit_runtime_status_segments(segments: _RuntimeStatusSegments, *, width: int) -> str:
+    if width <= 0:
+        return ""
+
+    full = _runtime_status_segments_text(segments)
+    if cell_len(full) <= width:
+        return full
+
+    if cell_len(segments.prefix) >= width:
+        return _truncate_status_line(segments.prefix, max_width=width)
+
+    if not segments.label:
+        return _truncate_status_line(segments.prefix, max_width=width)
+
+    prefix_label = f"{segments.prefix}{_STATUS_SEPARATOR}{segments.label}"
+    if segments.payload:
+        base = f"{prefix_label}{_STATUS_SEPARATOR}"
+        payload_width = width - cell_len(base)
+        if payload_width > 0:
+            payload = _truncate_status_line(segments.payload, max_width=payload_width)
+            return f"{base}{payload}".rstrip()
+
+    if cell_len(prefix_label) <= width:
+        return prefix_label
+
+    label_base = f"{segments.prefix}{_STATUS_SEPARATOR}"
+    label_width = width - cell_len(label_base)
+    if label_width > 0:
+        label = _truncate_status_line(segments.label, max_width=label_width)
+        return f"{label_base}{label}".rstrip()
+
+    return _truncate_status_line(segments.prefix, max_width=width)
+
+
+def _runtime_status_segments_text(segments: _RuntimeStatusSegments) -> str:
+    parts = [segments.prefix]
+    if segments.label:
+        parts.append(segments.label)
+    if segments.payload:
+        parts.append(segments.payload)
+    return _STATUS_SEPARATOR.join(parts)
+
+
 def _working_status_text(
     started_at: float,
     detail: str = "",