deepy-cli 0.1.4__tar.gz → 0.1.5__tar.gz

{deepy_cli-0.1.4 → deepy_cli-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deepy-cli
-Version: 0.1.4
+Version: 0.1.5
 Summary: Deepy - Vibe coding for DeepSeek models in your terminal
 Keywords: deepseek,coding-agent,terminal,cli,agents
 Author: kirineko
@@ -71,8 +71,8 @@ context state visible while the agent works.
 - Session history, `/resume`, `/new`, automatic context tracking, and compacting
   for long project work.
 - TOML-only private configuration at `~/.deepy/config.toml`.
-- Terminal UI with Markdown rendering, DeepSeek thinking display, per-turn usage,
-  context window status, and version update checks.
+- Theme-aware terminal UI with Markdown rendering, DeepSeek thinking display,
+  per-turn usage, context window status, and version update checks.
 
 ## See It Work
 
@@ -137,11 +137,17 @@ Deepy only uses TOML configuration. JSON config files are intentionally rejected
 
 ```toml
 # ~/.deepy/config.toml
+[model]
 api_key = "sk-..."
-model = "deepseek-v4-pro"
+name = "deepseek-v4-pro"
 base_url = "https://api.deepseek.com"
-context_window_tokens = 1048576
-compact_threshold = 0.8
+
+[context]
+window_tokens = 1048576
+compact_trigger_ratio = 0.8
+
+[ui]
+theme = "auto" # auto, dark, or light
 ```
 
 WebSearch uses Deepy's hosted SearXNG endpoint by default. You can override it
@@ -158,11 +164,21 @@ You can also initialize config non-interactively:
 deepy config init --api-key sk-... --model deepseek-v4-pro
 ```
 
+If your terminal uses a light background and parts of the UI look low contrast,
+set the UI theme explicitly:
+
+```bash
+deepy config theme light
+```
+
 ## Common Commands
 
 ```bash
 deepy --version
 deepy config setup
+deepy config reset
+deepy config theme
+deepy config theme light
 deepy doctor
 deepy doctor --live --json
 deepy status
@@ -178,6 +194,8 @@ Inside the interactive terminal:
 /skills   List available skills
 /new      Start a fresh conversation
 /resume   Pick a previous session
+/theme    Show or change UI theme
+/reset    Delete config and run setup again
 /         Open the command menu
 Esc       Interrupt the current model turn
 Ctrl+D    Press twice to quit
@@ -208,6 +226,6 @@ assets live outside the package directory and are not included in the wheel.
 
 ## Release Status
 
-Deepy is preparing its first public `0.1.4` release. The current release path is
+Deepy is preparing its first public `0.1.5` release. The current release path is
 GitHub + PyPI. Standalone binaries and npm wrappers can be added later, but the
 primary distribution is the Python CLI.

{deepy_cli-0.1.4 → deepy_cli-0.1.5}/README.md

@@ -43,8 +43,8 @@ context state visible while the agent works.
 - Session history, `/resume`, `/new`, automatic context tracking, and compacting
   for long project work.
 - TOML-only private configuration at `~/.deepy/config.toml`.
-- Terminal UI with Markdown rendering, DeepSeek thinking display, per-turn usage,
-  context window status, and version update checks.
+- Theme-aware terminal UI with Markdown rendering, DeepSeek thinking display,
+  per-turn usage, context window status, and version update checks.
 
 ## See It Work
 
@@ -109,11 +109,17 @@ Deepy only uses TOML configuration. JSON config files are intentionally rejected
 
 ```toml
 # ~/.deepy/config.toml
+[model]
 api_key = "sk-..."
-model = "deepseek-v4-pro"
+name = "deepseek-v4-pro"
 base_url = "https://api.deepseek.com"
-context_window_tokens = 1048576
-compact_threshold = 0.8
+
+[context]
+window_tokens = 1048576
+compact_trigger_ratio = 0.8
+
+[ui]
+theme = "auto" # auto, dark, or light
 ```
 
 WebSearch uses Deepy's hosted SearXNG endpoint by default. You can override it
@@ -130,11 +136,21 @@ You can also initialize config non-interactively:
 deepy config init --api-key sk-... --model deepseek-v4-pro
 ```
 
+If your terminal uses a light background and parts of the UI look low contrast,
+set the UI theme explicitly:
+
+```bash
+deepy config theme light
+```
+
 ## Common Commands
 
 ```bash
 deepy --version
 deepy config setup
+deepy config reset
+deepy config theme
+deepy config theme light
 deepy doctor
 deepy doctor --live --json
 deepy status
@@ -150,6 +166,8 @@ Inside the interactive terminal:
 /skills   List available skills
 /new      Start a fresh conversation
 /resume   Pick a previous session
+/theme    Show or change UI theme
+/reset    Delete config and run setup again
 /         Open the command menu
 Esc       Interrupt the current model turn
 Ctrl+D    Press twice to quit
@@ -180,6 +198,6 @@ assets live outside the package directory and are not included in the wheel.
 
 ## Release Status
 
-Deepy is preparing its first public `0.1.4` release. The current release path is
+Deepy is preparing its first public `0.1.5` release. The current release path is
 GitHub + PyPI. Standalone binaries and npm wrappers can be added later, but the
 primary distribution is the Python CLI.

{deepy_cli-0.1.4 → deepy_cli-0.1.5}/pyproject.toml

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

{deepy_cli-0.1.4 → deepy_cli-0.1.5}/src/deepy/__init__.py

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

{deepy_cli-0.1.4 → deepy_cli-0.1.5}/src/deepy/cli.py

@@ -2,7 +2,6 @@ from __future__ import annotations
 
 import argparse
 import asyncio
-import os
 import sys
 from pathlib import Path
 from typing import Sequence
@@ -10,8 +9,21 @@ from typing import Sequence
 import tomli_w
 
 from . import __version__
-from .config import Settings, load_settings, settings_to_toml_dict
-from .config.settings import DEFAULT_BASE_URL, DEFAULT_MODEL, DEFAULT_WEB_SEARCH_SEARXNG_URL
+from .config import (
+    Settings,
+    load_settings,
+    settings_to_toml_dict,
+    ui_theme_from_selection,
+    ui_theme_number,
+    update_config_theme,
+    write_config,
+)
+from .config.settings import (
+    DEFAULT_BASE_URL,
+    DEFAULT_MODEL,
+    DEFAULT_UI_THEME,
+    UI_THEMES,
+)
 from .errors import format_error_display
 from .llm.provider import build_provider_bundle
 from .llm.runner import DEFAULT_MAX_TURNS, run_prompt_once
@@ -20,6 +32,7 @@ from .skills import discover_skills, find_skill, format_skills_for_terminal, rea
 from .status import build_status_report, format_status_report, status_report_to_dict
 from .usage import TokenUsage, format_usage_line, usage_from_run_result
 from .ui import run_interactive
+from .ui.styles import resolve_ui_palette
 from .utils import json as json_utils
 
 
@@ -42,9 +55,13 @@ def _build_parser() -> argparse.ArgumentParser:
     init_parser.add_argument("--api-key", help="DeepSeek API key.")
     init_parser.add_argument("--model", default=DEFAULT_MODEL, help="Model name.")
     init_parser.add_argument("--base-url", default=DEFAULT_BASE_URL, help="OpenAI-compatible base URL.")
+    init_parser.add_argument("--theme", default=DEFAULT_UI_THEME, help="UI theme: auto, 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.")
 
     doctor_parser = subparsers.add_parser("doctor", help="Validate local Deepy setup.")
     doctor_parser.add_argument("--json", action="store_true", help="Print JSON diagnostics.")
@@ -101,6 +118,7 @@ def _cmd_config_init(args: argparse.Namespace) -> int:
         api_key=args.api_key or "",
         model=args.model,
         base_url=args.base_url,
+        theme=args.theme,
     )
     print(f"Wrote {config_path}")
     return 0
@@ -110,7 +128,7 @@ def _cmd_config_setup(args: argparse.Namespace) -> int:
     config_path = args.config.expanduser() if args.config else Path.home() / ".deepy" / "config.toml"
     if config_path.suffix == ".json":
         raise ValueError("Deepy only supports TOML config files; JSON config is not supported.")
-    if config_path.exists() and not args.force:
+    if config_path.exists():
         existing = load_settings(config_path)
     else:
         existing = Settings(path=config_path)
@@ -119,11 +137,26 @@ def _cmd_config_setup(args: argparse.Namespace) -> int:
     api_key = _prompt_config_value("API key", default=existing.model.api_key or "", is_password=True)
     model = _prompt_config_value("Model", default=existing.model.name)
     base_url = _prompt_config_value("Base URL", default=existing.model.base_url)
-    _write_config(config_path, api_key=api_key, model=model, base_url=base_url)
+    theme = _prompt_theme_value(default=existing.ui.theme)
+    _write_config(config_path, api_key=api_key, model=model, base_url=base_url, theme=theme)
     print(f"Wrote {config_path}")
     return 0
 
 
+def _cmd_config_reset(args: argparse.Namespace) -> int:
+    config_path = args.config.expanduser() if args.config else Path.home() / ".deepy" / "config.toml"
+    if config_path.suffix == ".json":
+        raise ValueError("Deepy only supports TOML config files; JSON config is not supported.")
+    if config_path.exists():
+        config_path.unlink()
+        print(f"Removed {config_path}")
+    else:
+        print(f"No existing config at {config_path}")
+    print("Starting Deepy configuration setup...")
+    setup_args = argparse.Namespace(config=args.config, force=True)
+    return _cmd_config_setup(setup_args)
+
+
 def _prompt_config_value(label: str, *, default: str, is_password: bool = False) -> str:
     from prompt_toolkit import PromptSession
 
@@ -136,36 +169,33 @@ def _prompt_config_value(label: str, *, default: str, is_password: bool = False)
     return value or default
 
 
-def _write_config(config_path: Path, *, api_key: str, model: str, base_url: str) -> None:
-    payload = {
-        "model": {
-            "name": model,
-            "base_url": base_url,
-            "api_key": api_key,
-            "thinking": True,
-            "reasoning_effort": "max",
-        },
-        "context": {
-            "window_tokens": 1_048_576,
-            "compact_trigger_ratio": 0.8,
-            "compact_prompt_token_threshold": 838_861,
-        },
-        "logging": {
-            "debug": False,
-        },
-        "notify": {
-            "enabled": False,
-            "command": "",
-        },
-        "tools": {
-            "web_search": {
-                "searxng_url": DEFAULT_WEB_SEARCH_SEARXNG_URL,
-            },
-        },
-    }
-    config_path.parent.mkdir(parents=True, exist_ok=True)
-    config_path.write_text(tomli_w.dumps(payload), encoding="utf-8")
-    os.chmod(config_path, 0o600)
+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")
+    value = _prompt_config_value("UI theme number", default=ui_theme_number(default))
+    return ui_theme_from_selection(value, default=default)
+
+
+def _write_config(config_path: Path, *, api_key: str, model: str, base_url: str, theme: str) -> None:
+    write_config(config_path, api_key=api_key, model=model, base_url=base_url, theme=theme)
+
+
+def _cmd_config_theme(args: argparse.Namespace) -> int:
+    settings = load_settings(args.config)
+    if args.theme is None:
+        palette = resolve_ui_palette(settings.ui.theme)
+        print(f"saved: {settings.ui.theme}")
+        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)
+        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)
+    print(f"Saved UI theme: {args.theme}")
+    return 0
 
 
 def _doctor(args: argparse.Namespace) -> tuple[int, dict[str, object]]:
@@ -385,6 +415,10 @@ def main(argv: Sequence[str] | None = None) -> int:
             return _cmd_config_init(args)
         if args.config_command == "setup":
             return _cmd_config_setup(args)
+        if args.config_command == "reset":
+            return _cmd_config_reset(args)
+        if args.config_command == "theme":
+            return _cmd_config_theme(args)
     if args.command == "doctor":
         return _cmd_doctor(args)
     if args.command == "run":
@@ -404,6 +438,10 @@ def main(argv: Sequence[str] | None = None) -> int:
         setup_args = argparse.Namespace(config=args.config, force=True)
         _cmd_config_setup(setup_args)
         settings = load_settings(args.config)
+    if settings.path is not None and not settings.ui.theme_configured:
+        theme = _prompt_theme_value(default=settings.ui.theme)
+        update_config_theme(settings.path, theme)
+        settings = load_settings(args.config)
     return run_interactive(settings)
 
 

{deepy_cli-0.1.4 → deepy_cli-0.1.5}/src/deepy/config/__init__.py

@@ -2,22 +2,40 @@ from __future__ import annotations
 
 from .settings import (
     ContextConfig,
+    DEFAULT_UI_THEME,
     DEFAULT_WEB_SEARCH_SEARXNG_URL,
     ModelConfig,
     Settings,
+    UI_THEME_OPTIONS,
+    UI_THEMES,
+    UiConfig,
     default_config_path,
+    is_valid_ui_theme,
     load_settings,
     mask_secret,
     settings_to_toml_dict,
+    update_config_theme,
+    ui_theme_from_selection,
+    ui_theme_number,
+    write_config,
 )
 
 __all__ = [
     "ContextConfig",
+    "DEFAULT_UI_THEME",
     "DEFAULT_WEB_SEARCH_SEARXNG_URL",
     "ModelConfig",
     "Settings",
+    "UI_THEME_OPTIONS",
+    "UI_THEMES",
+    "UiConfig",
     "default_config_path",
+    "is_valid_ui_theme",
     "load_settings",
     "mask_secret",
     "settings_to_toml_dict",
+    "update_config_theme",
+    "ui_theme_from_selection",
+    "ui_theme_number",
+    "write_config",
 ]

{deepy_cli-0.1.4 → deepy_cli-0.1.5}/src/deepy/config/settings.py

@@ -6,13 +6,18 @@ from dataclasses import asdict, dataclass, field
 from pathlib import Path
 from typing import Any, Mapping, Self
 
+import tomli_w
+
 DEFAULT_MODEL = "deepseek-v4-pro"
 DEFAULT_BASE_URL = "https://api.deepseek.com"
 DEFAULT_CONTEXT_WINDOW_TOKENS = 1_048_576
 DEFAULT_COMPACT_TRIGGER_RATIO = 0.8
 DEFAULT_COMPACT_PROMPT_TOKEN_THRESHOLD = 838_861
 DEFAULT_WEB_SEARCH_SEARXNG_URL = "https://s.kirineko.tech/"
+DEFAULT_UI_THEME = "auto"
 REASONING_EFFORTS = {"high", "max"}
+UI_THEMES = {"auto", "dark", "light"}
+UI_THEME_OPTIONS = (("1", "auto"), ("2", "dark"), ("3", "light"))
 
 
 def default_config_path() -> Path:
@@ -161,6 +166,19 @@ class ToolsConfig:
         return cls(web_search=WebSearchToolConfig.from_mapping(_as_mapping(raw.get("web_search"))))
 
 
+@dataclass(frozen=True)
+class UiConfig:
+    theme: str = DEFAULT_UI_THEME
+    theme_configured: bool = False
+
+    @classmethod
+    def from_mapping(cls, raw: Mapping[str, Any]) -> Self:
+        theme = raw.get("theme")
+        if isinstance(theme, str) and theme.strip() in UI_THEMES:
+            return cls(theme=theme.strip(), theme_configured=True)
+        return cls()
+
+
 @dataclass(frozen=True)
 class Settings:
     model: ModelConfig = field(default_factory=ModelConfig)
@@ -168,6 +186,7 @@ class Settings:
     logging: LoggingConfig = field(default_factory=LoggingConfig)
     notify: NotifyConfig = field(default_factory=NotifyConfig)
     tools: ToolsConfig = field(default_factory=ToolsConfig)
+    ui: UiConfig = field(default_factory=UiConfig)
     path: Path | None = None
 
     @classmethod
@@ -184,6 +203,7 @@ class Settings:
             logging=LoggingConfig.from_mapping(_as_mapping(raw.get("logging"))),
             notify=NotifyConfig.from_mapping(_as_mapping(raw.get("notify"))),
             tools=ToolsConfig.from_mapping(_as_mapping(raw.get("tools"))),
+            ui=UiConfig.from_mapping(_as_mapping(raw.get("ui"))),
             path=path,
         )
 
@@ -208,6 +228,8 @@ def load_settings(
 def settings_to_toml_dict(settings: Settings, *, reveal_secret: bool = False) -> dict[str, Any]:
     data = _drop_empty(asdict(settings))
     data.pop("path", None)
+    if "ui" in data:
+        data["ui"].pop("theme_configured", None)
     api_key = settings.model.api_key
     if api_key:
         data["model"]["api_key"] = api_key if reveal_secret else mask_secret(api_key)
@@ -218,6 +240,99 @@ def settings_to_toml_dict(settings: Settings, *, reveal_secret: bool = False) ->
     return _drop_empty(data)
 
 
+def is_valid_ui_theme(value: str) -> bool:
+    return value in UI_THEMES
+
+
+def ui_theme_number(theme: str) -> str:
+    for number, value in UI_THEME_OPTIONS:
+        if value == theme:
+            return number
+    return "1"
+
+
+def ui_theme_from_selection(value: str, *, default: str = DEFAULT_UI_THEME) -> str:
+    normalized = value.strip().lower()
+    if not normalized:
+        return default if is_valid_ui_theme(default) else DEFAULT_UI_THEME
+    if normalized in UI_THEMES:
+        return normalized
+    by_number = dict(UI_THEME_OPTIONS)
+    selected = by_number.get(normalized)
+    if selected is not None:
+        return selected
+    return default if is_valid_ui_theme(default) else DEFAULT_UI_THEME
+
+
+def write_config(
+    config_path: Path,
+    *,
+    api_key: str,
+    model: str,
+    base_url: str,
+    theme: str,
+) -> None:
+    if not is_valid_ui_theme(theme):
+        raise ValueError("UI theme must be one of: auto, dark, light.")
+    path = config_path.expanduser()
+    if path.suffix == ".json":
+        raise ValueError("Deepy only supports TOML config files; JSON config is not supported.")
+    payload = {
+        "model": {
+            "name": model,
+            "base_url": base_url,
+            "api_key": api_key,
+            "thinking": True,
+            "reasoning_effort": "max",
+        },
+        "context": {
+            "window_tokens": DEFAULT_CONTEXT_WINDOW_TOKENS,
+            "compact_trigger_ratio": DEFAULT_COMPACT_TRIGGER_RATIO,
+            "compact_prompt_token_threshold": DEFAULT_COMPACT_PROMPT_TOKEN_THRESHOLD,
+        },
+        "logging": {
+            "debug": False,
+        },
+        "notify": {
+            "enabled": False,
+            "command": "",
+        },
+        "tools": {
+            "web_search": {
+                "searxng_url": DEFAULT_WEB_SEARCH_SEARXNG_URL,
+            },
+        },
+        "ui": {
+            "theme": theme,
+        },
+    }
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(tomli_w.dumps(payload), encoding="utf-8")
+    os.chmod(path, 0o600)
+
+
+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.")
+    path = config_path.expanduser()
+    if path.suffix == ".json":
+        raise ValueError("Deepy only supports TOML config files; JSON config is not supported.")
+    raw: dict[str, Any]
+    if path.exists():
+        with path.open("rb") as fh:
+            loaded = tomllib.load(fh)
+        raw = dict(loaded)
+    else:
+        raw = {}
+    ui = raw.get("ui")
+    ui_map = dict(ui) if isinstance(ui, Mapping) else {}
+    ui_map["theme"] = theme
+    raw["ui"] = ui_map
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(tomli_w.dumps(raw), encoding="utf-8")
+    os.chmod(path, 0o600)
+
+
 def _drop_empty(value: Any) -> Any:
     if isinstance(value, dict):
         result = {}