deepy-cli 0.2.5__tar.gz → 0.2.7__tar.gz

{deepy_cli-0.2.5 → deepy_cli-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deepy-cli
-Version: 0.2.5
+Version: 0.2.7
 Summary: Deepy - Vibe coding for DeepSeek models in your terminal
 Keywords: deepseek,coding-agent,terminal,cli,agents
 Author: kirineko
@@ -18,7 +18,8 @@ Requires-Dist: orjson>=3.10,<4
 Requires-Dist: pydantic>=2.12,<3
 Requires-Dist: prompt-toolkit>=3.0,<4
 Requires-Dist: pyyaml>=6.0,<7
-Requires-Dist: rich>=13.9,<15
+Requires-Dist: rich>=14.2,<15
+Requires-Dist: textual>=8.2,<9
 Requires-Dist: tiktoken>=0.9,<1
 Requires-Dist: tomli-w>=1
 Requires-Python: >=3.12
@@ -153,6 +154,41 @@ cd your-project
 deepy
 ```
 
+### Experimental Textual TUI
+
+Deepy's stable default UI is still launched with `deepy`. Users who want to try
+the new opt-in Textual interface can run:
+
+```bash
+deepy tui
+```
+
+This first iteration focuses on experience and TUI-native interactions: a
+scrollable transcript, live thinking and assistant blocks, prompt suggestions
+for slash commands and `@file` mentions, status/help surfaces, and a Deepy-owned
+diff view. It is experimental and may change between releases.
+
+![Deepy Textual TUI](https://raw.githubusercontent.com/kirineko/deepy/main/asset/deepy-tui.webp)
+
+`/status` is available in both the stable terminal UI and the TUI. It shows
+session/project usage, context window pressure, and DeepSeek balance in one
+compact view. The balance API is called only when `/status` is invoked, not on
+startup, model turns, input suggestions, or exit.
+
+![Deepy TUI status panel](https://raw.githubusercontent.com/kirineko/deepy/main/asset/tui-status.webp)
+
+`/exit`, `/quit`, and pressing Ctrl+D twice now print the same compact session
+summary in both UIs.
+
+![Deepy TUI session summary](https://raw.githubusercontent.com/kirineko/deepy/main/asset/tui-summary.webp)
+
+Known limitations: the TUI does not add interactive shell/PTTY support yet, and
+toad / textual-diff-view are only design references. Deepy does not copy their
+AGPL source or depend on those packages.
+
+Please report feedback through GitHub Issues and include your terminal, shell,
+operating system, and the exact `deepy tui` workflow you tried.
+
 ## Installation Notes
 
 Use this order for a fresh machine:
@@ -213,6 +249,7 @@ Inside an interactive Deepy session:
 
 ```text
 /model       Select model and thinking strength
+/status      Show usage, context pressure, and DeepSeek balance
 /resume      Resume a previous project session
 /new         Start a fresh session
 /compact     Compact the active session context
@@ -303,6 +340,7 @@ deepy config theme
 deepy doctor
 deepy doctor --live --json
 deepy status
+deepy tui
 deepy skills list
 deepy sessions list
 deepy sessions show <session-id>
@@ -319,6 +357,7 @@ Inside the interactive terminal:
 /skill:<name> [request] Invoke a skill directly
 /init                   Create or update project AGENTS.md
 /mcp                    Show MCP server status and tools
+/status                 Show usage, context pressure, and DeepSeek balance
 ```
 
 ## AGENTS.md Instructions And Skills

{deepy_cli-0.2.5 → deepy_cli-0.2.7}/README.md

@@ -124,6 +124,41 @@ cd your-project
 deepy
 ```
 
+### Experimental Textual TUI
+
+Deepy's stable default UI is still launched with `deepy`. Users who want to try
+the new opt-in Textual interface can run:
+
+```bash
+deepy tui
+```
+
+This first iteration focuses on experience and TUI-native interactions: a
+scrollable transcript, live thinking and assistant blocks, prompt suggestions
+for slash commands and `@file` mentions, status/help surfaces, and a Deepy-owned
+diff view. It is experimental and may change between releases.
+
+![Deepy Textual TUI](https://raw.githubusercontent.com/kirineko/deepy/main/asset/deepy-tui.webp)
+
+`/status` is available in both the stable terminal UI and the TUI. It shows
+session/project usage, context window pressure, and DeepSeek balance in one
+compact view. The balance API is called only when `/status` is invoked, not on
+startup, model turns, input suggestions, or exit.
+
+![Deepy TUI status panel](https://raw.githubusercontent.com/kirineko/deepy/main/asset/tui-status.webp)
+
+`/exit`, `/quit`, and pressing Ctrl+D twice now print the same compact session
+summary in both UIs.
+
+![Deepy TUI session summary](https://raw.githubusercontent.com/kirineko/deepy/main/asset/tui-summary.webp)
+
+Known limitations: the TUI does not add interactive shell/PTTY support yet, and
+toad / textual-diff-view are only design references. Deepy does not copy their
+AGPL source or depend on those packages.
+
+Please report feedback through GitHub Issues and include your terminal, shell,
+operating system, and the exact `deepy tui` workflow you tried.
+
 ## Installation Notes
 
 Use this order for a fresh machine:
@@ -184,6 +219,7 @@ Inside an interactive Deepy session:
 
 ```text
 /model       Select model and thinking strength
+/status      Show usage, context pressure, and DeepSeek balance
 /resume      Resume a previous project session
 /new         Start a fresh session
 /compact     Compact the active session context
@@ -274,6 +310,7 @@ deepy config theme
 deepy doctor
 deepy doctor --live --json
 deepy status
+deepy tui
 deepy skills list
 deepy sessions list
 deepy sessions show <session-id>
@@ -290,6 +327,7 @@ Inside the interactive terminal:
 /skill:<name> [request] Invoke a skill directly
 /init                   Create or update project AGENTS.md
 /mcp                    Show MCP server status and tools
+/status                 Show usage, context pressure, and DeepSeek balance
 ```
 
 ## AGENTS.md Instructions And Skills

{deepy_cli-0.2.5 → deepy_cli-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepy-cli"
-version = "0.2.5"
+version = "0.2.7"
 description = "Deepy - Vibe coding for DeepSeek models in your terminal"
 readme = "README.md"
 authors = [
@@ -24,7 +24,8 @@ dependencies = [
     "pydantic>=2.12,<3",
     "prompt-toolkit>=3.0,<4",
     "pyyaml>=6.0,<7",
-    "rich>=13.9,<15",
+    "rich>=14.2,<15",
+    "textual>=8.2,<9",
     "tiktoken>=0.9,<1",
     "tomli-w>=1",
 ]

{deepy_cli-0.2.5 → deepy_cli-0.2.7}/src/deepy/__init__.py

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

{deepy_cli-0.2.5 → deepy_cli-0.2.7}/src/deepy/cli.py

@@ -78,6 +78,8 @@ def _build_parser() -> argparse.ArgumentParser:
     run_parser.add_argument("--session", help="Resume an existing session id.")
     run_parser.add_argument("--skill", action="append", default=[], help="Load a skill by name.")
 
+    subparsers.add_parser("tui", help="Start the experimental Textual TUI.")
+
     sessions_parser = subparsers.add_parser("sessions", help="Inspect project sessions.")
     sessions_sub = sessions_parser.add_subparsers(dest="sessions_command", required=True)
     sessions_sub.add_parser("list", help="List sessions for the current project.")
@@ -410,6 +412,29 @@ def _cmd_status(args: argparse.Namespace) -> int:
     return 0
 
 
+def _ensure_interactive_settings(args: argparse.Namespace) -> Settings:
+    settings = load_settings(args.config)
+    if not settings.model.api_key:
+        print("Deepy needs a DeepSeek API key before starting interactive mode.")
+        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 settings
+
+
+def _cmd_tui(args: argparse.Namespace) -> int:
+    if not sys.stdin.isatty():
+        print("experimental TUI requires a TTY; use `deepy` for the stable terminal UI.", file=sys.stderr)
+        return 1
+    from deepy.tui import run_tui
+
+    return run_tui(_ensure_interactive_settings(args), project_root=Path.cwd())
+
+
 def main(argv: Sequence[str] | None = None) -> int:
     parser = _build_parser()
     args = parser.parse_args(argv)
@@ -435,20 +460,12 @@ def main(argv: Sequence[str] | None = None) -> int:
         return _cmd_skills(args)
     if args.command == "status":
         return _cmd_status(args)
+    if args.command == "tui":
+        return _cmd_tui(args)
 
     if not sys.stdin.isatty():
         parser.error("interactive mode requires a TTY; use `deepy doctor` or `deepy config show`.")
-    settings = load_settings(args.config)
-    if not settings.model.api_key:
-        print("Deepy needs a DeepSeek API key before starting interactive mode.")
-        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)
+    return run_interactive(_ensure_interactive_settings(args))
 
 
 if __name__ == "__main__":

{deepy_cli-0.2.5 → deepy_cli-0.2.7}/src/deepy/config/__init__.py

@@ -4,6 +4,7 @@ from .settings import (
     ContextConfig,
     DEEPSEEK_MODEL_CATALOG,
     DEFAULT_COMPACT_PRESERVE_RECENT_MESSAGES,
+    DEFAULT_INPUT_SUGGESTIONS_ENABLED,
     DEFAULT_RESERVED_CONTEXT_TOKENS,
     DEFAULT_UI_THEME,
     DEFAULT_WEB_SEARCH_SEARXNG_URL,
@@ -26,6 +27,7 @@ from .settings import (
     mask_secret,
     settings_to_toml_dict,
     update_config_model_settings,
+    update_config_input_suggestions_enabled,
     update_config_theme,
     ui_theme_from_selection,
     ui_theme_number,
@@ -36,6 +38,7 @@ __all__ = [
     "ContextConfig",
     "DEEPSEEK_MODEL_CATALOG",
     "DEFAULT_COMPACT_PRESERVE_RECENT_MESSAGES",
+    "DEFAULT_INPUT_SUGGESTIONS_ENABLED",
     "DEFAULT_RESERVED_CONTEXT_TOKENS",
     "DEFAULT_UI_THEME",
     "DEFAULT_WEB_SEARCH_SEARXNG_URL",
@@ -58,6 +61,7 @@ __all__ = [
     "mask_secret",
     "settings_to_toml_dict",
     "update_config_model_settings",
+    "update_config_input_suggestions_enabled",
     "update_config_theme",
     "ui_theme_from_selection",
     "ui_theme_number",

{deepy_cli-0.2.5 → deepy_cli-0.2.7}/src/deepy/config/settings.py

@@ -21,6 +21,7 @@ DEFAULT_MCP_CONNECT_TIMEOUT_SECONDS = 10.0
 DEFAULT_MCP_CLEANUP_TIMEOUT_SECONDS = 10.0
 DEFAULT_MCP_CLIENT_SESSION_TIMEOUT_SECONDS = 30.0
 DEFAULT_MCP_CACHE_TOOLS_LIST = True
+DEFAULT_INPUT_SUGGESTIONS_ENABLED = True
 REASONING_EFFORTS = {"high", "max"}
 REASONING_MODES = {"none", "high", "max"}
 UI_THEMES = {"auto", "dark", "light"}
@@ -284,13 +285,22 @@ class McpConfig:
 class UiConfig:
     theme: str = DEFAULT_UI_THEME
     theme_configured: bool = False
+    input_suggestions_enabled: bool = DEFAULT_INPUT_SUGGESTIONS_ENABLED
 
     @classmethod
     def from_mapping(cls, raw: Mapping[str, Any]) -> Self:
         theme = raw.get("theme")
+        input_suggestions_enabled = _as_bool(
+            raw.get("input_suggestions_enabled"),
+            DEFAULT_INPUT_SUGGESTIONS_ENABLED,
+        )
         if isinstance(theme, str) and theme.strip() in UI_THEMES:
-            return cls(theme=theme.strip(), theme_configured=True)
-        return cls()
+            return cls(
+                theme=theme.strip(),
+                theme_configured=True,
+                input_suggestions_enabled=input_suggestions_enabled,
+            )
+        return cls(input_suggestions_enabled=input_suggestions_enabled)
 
 
 @dataclass(frozen=True)
@@ -441,6 +451,7 @@ def write_config(
         },
         "ui": {
             "theme": theme,
+            "input_suggestions_enabled": DEFAULT_INPUT_SUGGESTIONS_ENABLED,
         },
     }
     path.parent.mkdir(parents=True, exist_ok=True)
@@ -492,6 +503,18 @@ def update_config_theme(config_path: Path, theme: str) -> None:
     _write_private_toml(path, raw)
 
 
+def update_config_input_suggestions_enabled(config_path: Path, enabled: bool) -> None:
+    path = config_path.expanduser()
+    if path.suffix == ".json":
+        raise ValueError("Deepy only supports TOML config files; JSON config is not supported.")
+    raw = _read_toml_mapping(path)
+    ui = raw.get("ui")
+    ui_map = dict(ui) if isinstance(ui, Mapping) else {}
+    ui_map["input_suggestions_enabled"] = bool(enabled)
+    raw["ui"] = ui_map
+    _write_private_toml(path, raw)
+
+
 def _read_toml_mapping(path: Path) -> dict[str, Any]:
     if not path.exists():
         return {}