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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deepy-cli
-Version: 0.2.18
+Version: 0.2.20
 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
@@ -300,7 +306,7 @@ reserved_context_tokens = 50000
 compact_preserve_recent_messages = 2
 
 [ui]
-theme = "auto" # auto, dark, or light
+theme = "dark" # dark or light
 ```
 
 Set config without the interactive wizard:

{deepy_cli-0.2.18 → deepy_cli-0.2.20}/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
@@ -268,7 +274,7 @@ reserved_context_tokens = 50000
 compact_preserve_recent_messages = 2
 
 [ui]
-theme = "auto" # auto, dark, or light
+theme = "dark" # dark or light
 ```
 
 Set config without the interactive wizard:

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

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

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

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

{deepy_cli-0.2.18 → deepy_cli-0.2.20}/src/deepy/cli.py

@@ -61,13 +61,13 @@ def _build_parser() -> argparse.ArgumentParser:
     init_parser.add_argument("--model", help="Model name.")
     init_parser.add_argument("--base-url", help="OpenAI-compatible base URL.")
     init_parser.add_argument("--thinking", help="Thinking mode for the provider.")
-    init_parser.add_argument("--theme", default=DEFAULT_UI_THEME, help="UI theme: auto, dark, or light.")
+    init_parser.add_argument("--theme", default=DEFAULT_UI_THEME, help="UI theme: dark or light.")
     init_parser.add_argument("--force", action="store_true", help="Overwrite existing config.")
     setup_parser = config_sub.add_parser("setup", help="Interactively configure Deepy.")
     setup_parser.add_argument("--force", action="store_true", help="Overwrite existing config.")
     config_sub.add_parser("reset", help="Delete local config and run interactive setup again.")
     theme_parser = config_sub.add_parser("theme", help="Show or update terminal UI theme.")
-    theme_parser.add_argument("theme", nargs="?", help="Theme to save: auto, dark, or light.")
+    theme_parser.add_argument("theme", nargs="?", help="Theme to save: dark or light.")
 
     doctor_parser = subparsers.add_parser("doctor", help="Validate local Deepy setup.")
     doctor_parser.add_argument("--json", action="store_true", help="Print JSON diagnostics.")
@@ -381,9 +381,8 @@ def _thinking_mode_from_selection(provider: str, value: str, *, default: str) ->
 
 def _prompt_theme_value(*, default: str = DEFAULT_UI_THEME) -> str:
     print("UI theme:")
-    print("1. auto  Detect when possible; falls back to dark")
-    print("2. dark  Optimized for dark terminal backgrounds")
-    print("3. light Optimized for light terminal backgrounds")
+    print("1. dark  Optimized for dark terminal backgrounds")
+    print("2. light Optimized for light terminal backgrounds")
     value = _prompt_config_value("UI theme number", default=ui_theme_number(default))
     return ui_theme_from_selection(value, default=default)
 
@@ -417,7 +416,7 @@ def _cmd_config_theme(args: argparse.Namespace) -> int:
         print(f"resolved: {palette.name}")
         return 0
     if args.theme not in UI_THEMES:
-        print("Invalid theme. Usage: deepy config theme [auto|dark|light]", file=sys.stderr)
+        print("Invalid theme. Usage: deepy config theme [dark|light]", file=sys.stderr)
         return 1
     config_path = settings.path or (args.config.expanduser() if args.config else Path.home() / ".deepy" / "config.toml")
     update_config_theme(config_path, args.theme)

{deepy_cli-0.2.18 → deepy_cli-0.2.20}/src/deepy/config/settings.py

@@ -16,7 +16,7 @@ DEFAULT_COMPACT_TRIGGER_RATIO = 0.8
 DEFAULT_RESERVED_CONTEXT_TOKENS = 50_000
 DEFAULT_COMPACT_PRESERVE_RECENT_MESSAGES = 2
 DEFAULT_WEB_SEARCH_SEARXNG_URL = "https://s.kirineko.tech/"
-DEFAULT_UI_THEME = "auto"
+DEFAULT_UI_THEME = "dark"
 DEFAULT_MCP_ENABLED = True
 DEFAULT_MCP_CONNECT_TIMEOUT_SECONDS = 10.0
 DEFAULT_MCP_CLEANUP_TIMEOUT_SECONDS = 10.0
@@ -45,8 +45,8 @@ SWITCH_ONLY_THINKING_MODES = ("disabled", "enabled")
 REASONING_MODES = set(DEEPSEEK_REASONING_MODES)
 THINKING_MODES = set(DEEPSEEK_REASONING_MODES) | set(SWITCH_ONLY_THINKING_MODES) | OPENROUTER_REASONING_EFFORTS
 PROVIDERS = {"deepseek", "openrouter", "xiaomi"}
-UI_THEMES = {"auto", "dark", "light"}
-UI_THEME_OPTIONS = (("1", "auto"), ("2", "dark"), ("3", "light"))
+UI_THEMES = {"dark", "light"}
+UI_THEME_OPTIONS = (("1", "dark"), ("2", "light"))
 
 
 @dataclass(frozen=True)
@@ -570,6 +570,12 @@ class UiConfig:
             raw.get("input_suggestions_enabled"),
             DEFAULT_INPUT_SUGGESTIONS_ENABLED,
         )
+        if isinstance(theme, str) and theme.strip() == "auto":
+            return cls(
+                theme=DEFAULT_UI_THEME,
+                theme_configured=True,
+                input_suggestions_enabled=input_suggestions_enabled,
+            )
         if isinstance(theme, str) and theme.strip() in UI_THEMES:
             return cls(
                 theme=theme.strip(),
@@ -690,7 +696,7 @@ def write_config(
     thinking_mode: str | None = None,
 ) -> None:
     if not is_valid_ui_theme(theme):
-        raise ValueError("UI theme must be one of: auto, dark, light.")
+        raise ValueError("UI theme must be one of: dark, light.")
     if not is_supported_provider(provider):
         raise ValueError("Provider must be one of: deepseek, openrouter, xiaomi.")
     provider_info = provider_info_for(provider)
@@ -816,7 +822,7 @@ def update_config_model_settings(
 
 def update_config_theme(config_path: Path, theme: str) -> None:
     if not is_valid_ui_theme(theme):
-        raise ValueError("UI theme must be one of: auto, dark, light.")
+        raise ValueError("UI theme must be one of: dark, light.")
     path = config_path.expanduser()
     if path.suffix == ".json":
         raise ValueError("Deepy only supports TOML config files; JSON config is not supported.")

{deepy_cli-0.2.18 → deepy_cli-0.2.20}/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.20}/src/deepy/tui/app.py

@@ -823,7 +823,6 @@ class DeepyTuiApp(App[None]):
                 ChoiceScreen(
                     "Select theme",
                     [
-                        Choice("auto", "auto", "Follow saved/default theme behavior"),
                         Choice("dark", "dark", "Use Textual dark theme"),
                         Choice("light", "light", "Use Textual light theme"),
                     ],
@@ -833,7 +832,7 @@ class DeepyTuiApp(App[None]):
             self._update_status("Theme unchanged")
             return
         if not is_valid_ui_theme(theme):
-            await self._append_block(ErrorBlock("Usage: /theme auto|dark|light"))
+            await self._append_block(ErrorBlock("Usage: /theme dark|light"))
             return
         if self.settings.path is None:
             await self._append_block(ErrorBlock("Cannot persist theme: config path is unknown."))
@@ -2040,7 +2039,7 @@ def _reset_config_validation_error(result: ResetConfigResult) -> str:
     if not result.theme:
         return "Theme is required."
     if not is_valid_ui_theme(result.theme):
-        return "Usage: theme must be auto|dark|light"
+        return "Usage: theme must be dark|light"
     return ""
 
 

{deepy_cli-0.2.18 → deepy_cli-0.2.20}/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.20}/src/deepy/tui/screens.py

@@ -191,7 +191,7 @@ class ResetConfigScreen(ModalScreen[ResetConfigResult | None]):
             yield Input(value=self.model, placeholder="Model", id="reset-model")
             yield Input(value=self.base_url, placeholder="Base URL", id="reset-base-url")
             yield Input(value=self.thinking, placeholder="Thinking", id="reset-thinking")
-            yield Input(value=self.theme, placeholder="Theme: auto|dark|light", id="reset-theme")
+            yield Input(value=self.theme, placeholder="Theme: dark|light", id="reset-theme")
             yield Footer()
 
     def on_mount(self) -> None:

{deepy_cli-0.2.18 → deepy_cli-0.2.20}/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.20}/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.20}/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.20}/src/deepy/ui/status_footer.py

@@ -83,7 +83,7 @@ def _help_parts(help_text: str) -> list[tuple[FooterPartRole, str]]:
 
 
 def _known_title(text: str) -> str | None:
-    for title in ("provider", "model", "cwd", "mcp", "bg", "ctx", "newline"):
+    for title in ("provider", "model", "cwd", "mcp", "update", "bg", "ctx", "newline"):
         if text == title or text.startswith(f"{title} ") or text.startswith(f"{title}:"):
             return title
     return None