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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deepy-cli
-Version: 0.1.4
+Version: 0.1.6
 Summary: Deepy - Vibe coding for DeepSeek models in your terminal
 Keywords: deepseek,coding-agent,terminal,cli,agents
 Author: kirineko
@@ -62,7 +62,8 @@ context state visible while the agent works.
 ## Highlights
 
 - DeepSeek-first model setup with `deepseek-v4-pro`, thinking enabled, and
-  `reasoning_effort=max` by default.
+  `reasoning_effort=max` by default; `/model` can switch between V4 Pro and V4
+  Flash with `none`, `high`, or `max` thinking strength.
 - OpenAI Agents SDK integration through `OpenAIChatCompletionsModel`.
 - Project-aware coding tools for reading files, modifying files, running shell
   commands, and showing readable diffs.
@@ -71,8 +72,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,13 +138,28 @@ 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
+thinking = true
+reasoning_effort = "max" # high or max when thinking is enabled
+
+[context]
+window_tokens = 1048576
+compact_trigger_ratio = 0.8
+reserved_context_tokens = 50000
+compact_preserve_recent_messages = 2
+
+[ui]
+theme = "auto" # auto, dark, or light
 ```
 
+Supported interactive model choices are `deepseek-v4-pro` and
+`deepseek-v4-flash`. In `/model`, thinking strength `none` saves
+`thinking = false`; `high` and `max` save `thinking = true` with the matching
+`reasoning_effort`.
+
 WebSearch uses Deepy's hosted SearXNG endpoint by default. You can override it
 with your own SearXNG instance:
 
@@ -158,11 +174,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
@@ -176,8 +202,12 @@ Inside the interactive terminal:
 
 ```text
 /skills   List available skills
+/model    Select model and thinking strength
 /new      Start a fresh conversation
 /resume   Pick a previous session
+/compact  Compact the active session context
+/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 +238,5 @@ 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
-GitHub + PyPI. Standalone binaries and npm wrappers can be added later, but the
-primary distribution is the Python CLI.
+Deepy `0.1.6` is released through GitHub and 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.6}/README.md

@@ -34,7 +34,8 @@ context state visible while the agent works.
 ## Highlights
 
 - DeepSeek-first model setup with `deepseek-v4-pro`, thinking enabled, and
-  `reasoning_effort=max` by default.
+  `reasoning_effort=max` by default; `/model` can switch between V4 Pro and V4
+  Flash with `none`, `high`, or `max` thinking strength.
 - OpenAI Agents SDK integration through `OpenAIChatCompletionsModel`.
 - Project-aware coding tools for reading files, modifying files, running shell
   commands, and showing readable diffs.
@@ -43,8 +44,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,13 +110,28 @@ 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
+thinking = true
+reasoning_effort = "max" # high or max when thinking is enabled
+
+[context]
+window_tokens = 1048576
+compact_trigger_ratio = 0.8
+reserved_context_tokens = 50000
+compact_preserve_recent_messages = 2
+
+[ui]
+theme = "auto" # auto, dark, or light
 ```
 
+Supported interactive model choices are `deepseek-v4-pro` and
+`deepseek-v4-flash`. In `/model`, thinking strength `none` saves
+`thinking = false`; `high` and `max` save `thinking = true` with the matching
+`reasoning_effort`.
+
 WebSearch uses Deepy's hosted SearXNG endpoint by default. You can override it
 with your own SearXNG instance:
 
@@ -130,11 +146,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
@@ -148,8 +174,12 @@ Inside the interactive terminal:
 
 ```text
 /skills   List available skills
+/model    Select model and thinking strength
 /new      Start a fresh conversation
 /resume   Pick a previous session
+/compact  Compact the active session context
+/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 +210,5 @@ 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
-GitHub + PyPI. Standalone binaries and npm wrappers can be added later, but the
-primary distribution is the Python CLI.
+Deepy `0.1.6` is released through GitHub and 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.6}/pyproject.toml

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

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

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

{deepy_cli-0.1.4 → deepy_cli-0.1.6}/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]]:
@@ -196,6 +226,11 @@ def _doctor(args: argparse.Namespace) -> tuple[int, dict[str, object]]:
         or settings.context.resolved_compact_threshold > 0,
         str(settings.context.resolved_compact_threshold),
     )
+    check(
+        "reserved_context",
+        settings.context.reserved_context_tokens > 0,
+        str(settings.context.reserved_context_tokens),
+    )
 
     try:
         build_provider_bundle(settings)
@@ -211,6 +246,7 @@ def _doctor(args: argparse.Namespace) -> tuple[int, dict[str, object]]:
         "thinking": {
             "enabled": settings.model.thinking_enabled,
             "reasoning_effort": settings.model.reasoning_effort,
+            "reasoning_mode": settings.model.reasoning_mode,
         },
     }
 
@@ -276,7 +312,7 @@ def _cmd_doctor(args: argparse.Namespace) -> int:
         status = "ok" if item["ok"] else "fail"
         print(f"{status:4} {item['name']}: {item['detail']}")
     thinking = report["thinking"]
-    print(f"info thinking: enabled={thinking['enabled']} effort={thinking['reasoning_effort']}")
+    print(f"info reasoning: mode={thinking['reasoning_mode']}")
     live = report.get("live")
     if isinstance(live, dict):
         if live.get("ok"):
@@ -385,6 +421,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 +444,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.6/src/deepy/config/__init__.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from .settings import (
+    ContextConfig,
+    DEEPSEEK_MODEL_CATALOG,
+    DEFAULT_COMPACT_PRESERVE_RECENT_MESSAGES,
+    DEFAULT_RESERVED_CONTEXT_TOKENS,
+    DEFAULT_UI_THEME,
+    DEFAULT_WEB_SEARCH_SEARXNG_URL,
+    DeepSeekModelInfo,
+    ModelConfig,
+    REASONING_MODES,
+    Settings,
+    SUPPORTED_DEEPSEEK_MODELS,
+    UI_THEME_OPTIONS,
+    UI_THEMES,
+    UiConfig,
+    default_config_path,
+    is_supported_deepseek_model,
+    is_valid_ui_theme,
+    is_valid_reasoning_mode,
+    load_settings,
+    mask_secret,
+    settings_to_toml_dict,
+    update_config_model_settings,
+    update_config_theme,
+    ui_theme_from_selection,
+    ui_theme_number,
+    write_config,
+)
+
+__all__ = [
+    "ContextConfig",
+    "DEEPSEEK_MODEL_CATALOG",
+    "DEFAULT_COMPACT_PRESERVE_RECENT_MESSAGES",
+    "DEFAULT_RESERVED_CONTEXT_TOKENS",
+    "DEFAULT_UI_THEME",
+    "DEFAULT_WEB_SEARCH_SEARXNG_URL",
+    "DeepSeekModelInfo",
+    "ModelConfig",
+    "REASONING_MODES",
+    "Settings",
+    "SUPPORTED_DEEPSEEK_MODELS",
+    "UI_THEME_OPTIONS",
+    "UI_THEMES",
+    "UiConfig",
+    "default_config_path",
+    "is_supported_deepseek_model",
+    "is_valid_ui_theme",
+    "is_valid_reasoning_mode",
+    "load_settings",
+    "mask_secret",
+    "settings_to_toml_dict",
+    "update_config_model_settings",
+    "update_config_theme",
+    "ui_theme_from_selection",
+    "ui_theme_number",
+    "write_config",
+]