deepy-cli 0.1.11__tar.gz → 0.1.13__tar.gz

deepy_cli-0.1.13/PKG-INFO

@@ -0,0 +1,308 @@
+Metadata-Version: 2.3
+Name: deepy-cli
+Version: 0.1.13
+Summary: Deepy - Vibe coding for DeepSeek models in your terminal
+Keywords: deepseek,coding-agent,terminal,cli,agents
+Author: kirineko
+Author-email: kirineko <kirineko@qq.com>
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Terminals
+Requires-Dist: openai-agents>=0.17.0
+Requires-Dist: openai>=2.26,<3
+Requires-Dist: orjson>=3.10,<4
+Requires-Dist: pydantic>=2.12,<3
+Requires-Dist: prompt-toolkit>=3.0,<4
+Requires-Dist: rich>=13.9,<15
+Requires-Dist: tiktoken>=0.9,<1
+Requires-Dist: tomli-w>=1
+Requires-Python: >=3.12
+Project-URL: Homepage, https://kirineko.github.io/deepy/
+Project-URL: Repository, https://github.com/kirineko/deepy
+Project-URL: Issues, https://github.com/kirineko/deepy/issues
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kirineko/deepy/main/asset/deepy-logo.webp" alt="Deepy logo" width="144">
+</p>
+
+<h1 align="center">Deepy</h1>
+
+<p align="center">
+  A terminal coding agent built for DeepSeek.
+  <br>
+  Read projects, edit files, run commands, search the web, and keep long project context in one recoverable terminal session.
+</p>
+
+<p align="center">
+  <a href="https://kirineko.github.io/deepy/">Website</a>
+  ·
+  <a href="README.zh-CN.md">中文文档</a>
+  ·
+  <a href="#quick-start">Quick Start</a>
+  ·
+  <a href="#daily-workflow">Daily Workflow</a>
+</p>
+
+![Deepy terminal welcome screen](https://raw.githubusercontent.com/kirineko/deepy/main/asset/welcome.webp)
+
+## What Deepy Does
+
+Deepy is a Python CLI coding agent for DeepSeek's OpenAI-compatible models. It
+keeps the working loop inside your terminal: inspect a project, ask questions,
+modify code, run validation commands, search or fetch web pages, and resume the
+same project session later.
+
+Deepy is optimized for DeepSeek V4 thinking mode, long context, cache-friendly
+prompting, and a Rich terminal UI that makes the agent's actions visible instead
+of hiding tool calls behind chat text.
+
+## Why Use It
+
+- **DeepSeek-first defaults**: starts with `deepseek-v4-pro`, thinking enabled,
+  and `reasoning_effort=max`. Use `/model` to switch V4 Pro / V4 Flash and
+  choose `none`, `high`, or `max` thinking strength.
+- **Project-aware coding tools**: read files, write new files, modify existing
+  files with stale-write protection, run shell commands, and review readable
+  diffs.
+- **Visible terminal transcript**: thinking, tool calls, shell output, usage,
+  context status, and command results are shown in the terminal.
+- **Research from the terminal**: use WebSearch for discovery and WebFetch when
+  you already have an exact URL.
+- **Long-session continuity**: JSONL sessions, `/resume`, `/new`, context window
+  status, automatic compacting, and manual `/compact`.
+- **Local command mode**: type `!cmd` to run a non-interactive local shell command
+  without sending it to the model; the result is still saved as context.
+- **Cross-platform shell handling**: POSIX shell, PowerShell, cmd, Windows paths,
+  UTF-8 output, CRLF editing, and non-interactive Windows local command mode.
+
+## See It Work
+
+### Terminal-Centered Agent Loop
+
+Deepy keeps model reasoning, WebFetch, shell output, and status lines visible in
+one transcript.
+
+![Deepy thinking, WebFetch, and shell output](https://raw.githubusercontent.com/kirineko/deepy/main/asset/webfetch-shell-thinking.webp)
+
+### Code Editing With Reviewable Diff
+
+File edits are shown with path information and readable diff output so you can
+inspect what changed before continuing.
+
+![Deepy edit diff preview](https://raw.githubusercontent.com/kirineko/deepy/main/asset/edit-diff.webp)
+
+### Search, Fetch, And Local Commands
+
+Use WebSearch / WebFetch for external context, `@` for file mentions, and `!`
+for direct local commands.
+
+![Deepy web research workflow](https://raw.githubusercontent.com/kirineko/deepy/main/asset/websearch.webp)
+
+![Deepy local command mode](https://raw.githubusercontent.com/kirineko/deepy/main/asset/command_mode.webp)
+
+## Quick Start
+
+1. Install `uv`:
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows PowerShell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+2. Configure a uv mirror.
+
+Linux / macOS: `~/.config/uv/uv.toml`
+
+```toml
+[[index]]
+url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
+default = true
+```
+
+Windows: `%AppData%\uv\uv.toml`
+
+```toml
+[[index]]
+url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
+default = true
+```
+
+3. Install Deepy:
+
+```bash
+uv tool install deepy-cli
+```
+
+The installed command is `deepy`.
+
+4. Configure your DeepSeek API key and start Deepy:
+
+```bash
+deepy config setup
+
+cd your-project
+deepy
+```
+
+## Installation Notes
+
+Use this order for a fresh machine:
+
+### 1. Install uv
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows PowerShell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### 2. Configure a uv mirror
+
+Linux / macOS: `~/.config/uv/uv.toml`
+
+```toml
+[[index]]
+url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
+default = true
+```
+
+Windows: `%AppData%\uv\uv.toml`
+
+```toml
+[[index]]
+url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
+default = true
+```
+
+### 3. Install Deepy
+
+```bash
+uv tool install deepy-cli
+```
+
+### 4. Configure and start
+
+```bash
+deepy config setup
+
+cd your-project
+deepy
+```
+
+Upgrade or uninstall Deepy:
+
+```bash
+uv tool upgrade deepy-cli
+uv tool uninstall deepy-cli
+```
+
+## Daily Workflow
+
+Inside an interactive Deepy session:
+
+```text
+/model       Select model and thinking strength
+/resume      Resume a previous project session
+/new         Start a fresh session
+/compact     Compact the active session context
+/theme       Show or change terminal UI theme
+@src/app.py  Mention a file in the current project
+!pytest -q   Run a local non-interactive command
+Esc          Interrupt the current model turn
+Ctrl+D       Press twice to quit
+```
+
+Typical usage:
+
+```text
+Ask Deepy to inspect a bug, edit files, run tests, and summarize what changed.
+Use @ to reference files precisely.
+Use ! for commands you want to run directly without model mediation.
+Use /resume when returning to a project later.
+Use /compact when a long session needs a durable summary.
+```
+
+## Configuration
+
+Deepy uses TOML configuration at `~/.deepy/config.toml`.
+
+```toml
+[model]
+api_key = "sk-..."
+name = "deepseek-v4-pro"
+base_url = "https://api.deepseek.com"
+thinking = true
+reasoning_effort = "max"
+
+[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
+```
+
+Set config without the interactive wizard:
+
+```bash
+deepy config init --api-key sk-... --model deepseek-v4-pro
+deepy config theme light
+```
+
+WebSearch uses Deepy's hosted SearXNG endpoint by default. You can override it:
+
+```toml
+[tools.web_search]
+searxng_url = "https://your-searxng.example/"
+```
+
+## Command Reference
+
+```bash
+deepy --version
+deepy config setup
+deepy config reset
+deepy config theme
+deepy doctor
+deepy doctor --live --json
+deepy status
+deepy skills list
+deepy sessions list
+deepy sessions show <session-id>
+deepy run "summarize this project"
+```
+
+## Project Rules And Skills
+
+Deepy automatically loads project instructions from:
+
+- `AGENTS.md`
+- `.deepy/skills/*/SKILL.md`
+
+This lets each repository define local conventions, commands, review rules, and
+domain-specific workflows without changing global config.
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run ruff check
+uv run pyright
+uv build
+```
+
+The Python package is built from `src/deepy`. GitHub Pages files and screenshot
+assets live outside the package directory and are not included in the wheel.

deepy_cli-0.1.13/README.md

@@ -0,0 +1,280 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kirineko/deepy/main/asset/deepy-logo.webp" alt="Deepy logo" width="144">
+</p>
+
+<h1 align="center">Deepy</h1>
+
+<p align="center">
+  A terminal coding agent built for DeepSeek.
+  <br>
+  Read projects, edit files, run commands, search the web, and keep long project context in one recoverable terminal session.
+</p>
+
+<p align="center">
+  <a href="https://kirineko.github.io/deepy/">Website</a>
+  ·
+  <a href="README.zh-CN.md">中文文档</a>
+  ·
+  <a href="#quick-start">Quick Start</a>
+  ·
+  <a href="#daily-workflow">Daily Workflow</a>
+</p>
+
+![Deepy terminal welcome screen](https://raw.githubusercontent.com/kirineko/deepy/main/asset/welcome.webp)
+
+## What Deepy Does
+
+Deepy is a Python CLI coding agent for DeepSeek's OpenAI-compatible models. It
+keeps the working loop inside your terminal: inspect a project, ask questions,
+modify code, run validation commands, search or fetch web pages, and resume the
+same project session later.
+
+Deepy is optimized for DeepSeek V4 thinking mode, long context, cache-friendly
+prompting, and a Rich terminal UI that makes the agent's actions visible instead
+of hiding tool calls behind chat text.
+
+## Why Use It
+
+- **DeepSeek-first defaults**: starts with `deepseek-v4-pro`, thinking enabled,
+  and `reasoning_effort=max`. Use `/model` to switch V4 Pro / V4 Flash and
+  choose `none`, `high`, or `max` thinking strength.
+- **Project-aware coding tools**: read files, write new files, modify existing
+  files with stale-write protection, run shell commands, and review readable
+  diffs.
+- **Visible terminal transcript**: thinking, tool calls, shell output, usage,
+  context status, and command results are shown in the terminal.
+- **Research from the terminal**: use WebSearch for discovery and WebFetch when
+  you already have an exact URL.
+- **Long-session continuity**: JSONL sessions, `/resume`, `/new`, context window
+  status, automatic compacting, and manual `/compact`.
+- **Local command mode**: type `!cmd` to run a non-interactive local shell command
+  without sending it to the model; the result is still saved as context.
+- **Cross-platform shell handling**: POSIX shell, PowerShell, cmd, Windows paths,
+  UTF-8 output, CRLF editing, and non-interactive Windows local command mode.
+
+## See It Work
+
+### Terminal-Centered Agent Loop
+
+Deepy keeps model reasoning, WebFetch, shell output, and status lines visible in
+one transcript.
+
+![Deepy thinking, WebFetch, and shell output](https://raw.githubusercontent.com/kirineko/deepy/main/asset/webfetch-shell-thinking.webp)
+
+### Code Editing With Reviewable Diff
+
+File edits are shown with path information and readable diff output so you can
+inspect what changed before continuing.
+
+![Deepy edit diff preview](https://raw.githubusercontent.com/kirineko/deepy/main/asset/edit-diff.webp)
+
+### Search, Fetch, And Local Commands
+
+Use WebSearch / WebFetch for external context, `@` for file mentions, and `!`
+for direct local commands.
+
+![Deepy web research workflow](https://raw.githubusercontent.com/kirineko/deepy/main/asset/websearch.webp)
+
+![Deepy local command mode](https://raw.githubusercontent.com/kirineko/deepy/main/asset/command_mode.webp)
+
+## Quick Start
+
+1. Install `uv`:
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows PowerShell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+2. Configure a uv mirror.
+
+Linux / macOS: `~/.config/uv/uv.toml`
+
+```toml
+[[index]]
+url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
+default = true
+```
+
+Windows: `%AppData%\uv\uv.toml`
+
+```toml
+[[index]]
+url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
+default = true
+```
+
+3. Install Deepy:
+
+```bash
+uv tool install deepy-cli
+```
+
+The installed command is `deepy`.
+
+4. Configure your DeepSeek API key and start Deepy:
+
+```bash
+deepy config setup
+
+cd your-project
+deepy
+```
+
+## Installation Notes
+
+Use this order for a fresh machine:
+
+### 1. Install uv
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows PowerShell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### 2. Configure a uv mirror
+
+Linux / macOS: `~/.config/uv/uv.toml`
+
+```toml
+[[index]]
+url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
+default = true
+```
+
+Windows: `%AppData%\uv\uv.toml`
+
+```toml
+[[index]]
+url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
+default = true
+```
+
+### 3. Install Deepy
+
+```bash
+uv tool install deepy-cli
+```
+
+### 4. Configure and start
+
+```bash
+deepy config setup
+
+cd your-project
+deepy
+```
+
+Upgrade or uninstall Deepy:
+
+```bash
+uv tool upgrade deepy-cli
+uv tool uninstall deepy-cli
+```
+
+## Daily Workflow
+
+Inside an interactive Deepy session:
+
+```text
+/model       Select model and thinking strength
+/resume      Resume a previous project session
+/new         Start a fresh session
+/compact     Compact the active session context
+/theme       Show or change terminal UI theme
+@src/app.py  Mention a file in the current project
+!pytest -q   Run a local non-interactive command
+Esc          Interrupt the current model turn
+Ctrl+D       Press twice to quit
+```
+
+Typical usage:
+
+```text
+Ask Deepy to inspect a bug, edit files, run tests, and summarize what changed.
+Use @ to reference files precisely.
+Use ! for commands you want to run directly without model mediation.
+Use /resume when returning to a project later.
+Use /compact when a long session needs a durable summary.
+```
+
+## Configuration
+
+Deepy uses TOML configuration at `~/.deepy/config.toml`.
+
+```toml
+[model]
+api_key = "sk-..."
+name = "deepseek-v4-pro"
+base_url = "https://api.deepseek.com"
+thinking = true
+reasoning_effort = "max"
+
+[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
+```
+
+Set config without the interactive wizard:
+
+```bash
+deepy config init --api-key sk-... --model deepseek-v4-pro
+deepy config theme light
+```
+
+WebSearch uses Deepy's hosted SearXNG endpoint by default. You can override it:
+
+```toml
+[tools.web_search]
+searxng_url = "https://your-searxng.example/"
+```
+
+## Command Reference
+
+```bash
+deepy --version
+deepy config setup
+deepy config reset
+deepy config theme
+deepy doctor
+deepy doctor --live --json
+deepy status
+deepy skills list
+deepy sessions list
+deepy sessions show <session-id>
+deepy run "summarize this project"
+```
+
+## Project Rules And Skills
+
+Deepy automatically loads project instructions from:
+
+- `AGENTS.md`
+- `.deepy/skills/*/SKILL.md`
+
+This lets each repository define local conventions, commands, review rules, and
+domain-specific workflows without changing global config.
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest
+uv run ruff check
+uv run pyright
+uv build
+```
+
+The Python package is built from `src/deepy`. GitHub Pages files and screenshot
+assets live outside the package directory and are not included in the wheel.

{deepy_cli-0.1.11 → deepy_cli-0.1.13}/pyproject.toml

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

{deepy_cli-0.1.11 → deepy_cli-0.1.13}/src/deepy/__init__.py

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

{deepy_cli-0.1.11 → deepy_cli-0.1.13}/src/deepy/cli.py

@@ -362,7 +362,7 @@ def _cmd_sessions(args: argparse.Namespace) -> int:
             return 0
         for entry in entries:
             print(
-                f"{entry.id}\tupdated={entry.updated_at}\thistory_tokens={entry.active_tokens}\t"
+                f"{entry.id}\tupdated={entry.updated_at}\thistory_estimate={entry.active_tokens}\t"
                 f"{format_usage_line(entry.usage)}"
             )
         return 0

{deepy_cli-0.1.11 → deepy_cli-0.1.13}/src/deepy/data/tools/shell.md

@@ -10,8 +10,9 @@ PowerShell commands and Windows paths, `cmd` uses cmd syntax, and `posix` uses
 POSIX shell syntax.
 
 On Windows PowerShell, Python child processes run with UTF-8 I/O defaults for
-the command invocation; do not ask users to run `chcp` or change their
-PowerShell profile for Unicode output.
+the command invocation. Deepy also decodes captured output from Windows-native
+commands with UTF-8, UTF-16, and GBK-compatible fallbacks. Do not ask users to
+run `chcp` or change their PowerShell profile for Unicode output.
 
 Runs in the session cwd, preserves cwd between calls when supported, and returns
 stdout/stderr JSON with cwd, exit-code, and shell metadata.

{deepy_cli-0.1.11 → deepy_cli-0.1.13}/src/deepy/llm/compaction.py

@@ -10,7 +10,7 @@ from deepy.prompts.compact import build_compact_prompt, build_compact_summary_me
 from deepy.sessions.jsonl import DeepyJsonlSession
 from deepy.usage import TokenUsage, usage_from_run_result
 
-from .context import estimate_tokens_for_item, estimate_tokens_for_items, should_auto_compact
+from .context import estimate_tokens_for_item, estimate_tokens_for_items
 from .provider import ProviderBundle, build_provider_bundle
 from .replay import sanitize_sdk_items_for_replay
 
@@ -52,7 +52,13 @@ async def compact_session(
     focus_instruction: str | None = None,
 ) -> CompactionResult:
     items = await session.get_items()
-    before_tokens = session.context_token_state().active_tokens
+    before_estimated_tokens = session.context_token_state().active_tokens
+    before_context_usage = session.latest_context_window_usage()
+    before_tokens = (
+        before_context_usage.used_tokens
+        if before_context_usage is not None
+        else before_estimated_tokens
+    )
     prepared = prepare_compaction_items(
         items,
         preserve_recent_messages=settings.context.compact_preserve_recent_messages,
@@ -116,13 +122,14 @@ async def ensure_context_ready(
     additional_tokens = estimate_tokens_for_item(additional_input or "")
     state = session.context_token_state()
     before_tokens = state.active_tokens + additional_tokens
+    latest_context_usage = session.latest_context_window_usage()
+    trigger_tokens = (
+        latest_context_usage.used_tokens
+        if latest_context_usage is not None
+        else before_tokens
+    )
     compacted: CompactionResult | None = None
-    if should_auto_compact(
-        before_tokens,
-        settings.context.window_tokens,
-        trigger_ratio=settings.context.compact_trigger_ratio,
-        reserved_context_size=settings.context.reserved_context_tokens,
-    ):
+    if trigger_tokens >= settings.context.resolved_compact_threshold:
         compacted = await compact_session(
             session,
             settings,
@@ -132,10 +139,19 @@ async def ensure_context_ready(
 
     after_state = session.context_token_state()
     after_tokens = after_state.active_tokens + additional_tokens
-    if after_tokens + settings.context.reserved_context_tokens >= settings.context.window_tokens:
+    if compacted and compacted.compacted:
+        fit_tokens = after_tokens
+    else:
+        after_context_usage = session.latest_context_window_usage()
+        fit_tokens = (
+            after_context_usage.used_tokens
+            if after_context_usage is not None
+            else after_tokens
+        )
+    if fit_tokens + settings.context.reserved_context_tokens >= settings.context.window_tokens:
         raise ContextCompactionError(
             "Context exceeds the configured window and could not be compacted enough "
-            f"({after_tokens:,} tokens + {settings.context.reserved_context_tokens:,} reserved "
+            f"({fit_tokens:,} tokens + {settings.context.reserved_context_tokens:,} reserved "
             f">= {settings.context.window_tokens:,} window)."
         )
     return ContextReadiness(