ripperdoc 0.2.9__tar.gz → 0.3.0__tar.gz

{ripperdoc-0.2.9 → ripperdoc-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ripperdoc
-Version: 0.2.9
+Version: 0.3.0
 Summary: AI-powered terminal assistant for coding tasks
 Author: Ripperdoc Team
 License: Apache-2.0
@@ -23,16 +23,23 @@ Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: aiofiles>=23.0.0
 Requires-Dist: prompt-toolkit>=3.0.0
 Requires-Dist: PyYAML>=6.0.0
-Requires-Dist: mcp[cli]>=1.22.0
+Requires-Dist: mcp[cli]>=1.25.0
 Requires-Dist: json_repair>=0.54.2
 Requires-Dist: tiktoken>=0.7.0
 Requires-Dist: google-genai>=0.3.0
+Requires-Dist: charset-normalizer>=3.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.39.0; extra == "anthropic"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: gemini
+Requires-Dist: google-genai>=0.3.0; extra == "gemini"
 Dynamic: license-file
 
 <div align="center">
@@ -93,27 +100,22 @@ pip install git+https://github.com/quantmew/ripperdoc.git
 Or install from source:
 ```bash
 # Clone the repository
-git clone <repository-url>
-cd Ripperdoc
+git clone https://github.com/quantmew/ripperdoc.git
+cd ripperdoc
 
 # Install from source
 pip install -e .
 ```
 
-### Configuration
 
-Set your API key as an environment variable:
-```bash
-export OPENAI_API_KEY="your-api-key-here"
-# or for Anthropic Claude
-export ANTHROPIC_API_KEY="your-api-key-here"
-```
 
 ## Usage
 
 ### Interactive Mode (Recommended)
 ```bash
 ripperdoc
+# or use the short alias
+rd
 ```
 
 This launches an interactive session where you can:
@@ -122,6 +124,13 @@ This launches an interactive session where you can:
 - Execute commands
 - Navigate and explore files
 
+**Options:**
+- `--yolo` - Skip permission prompts (safe mode is on by default)
+- `--model <model_name>` - Specify a model (e.g., `claude-sonnet-4-20250514`, `gpt-4o`)
+- `--tools <tool_list>` - Filter available tools (comma-separated, or "" for none)
+- `--no-mcp` - Disable MCP server integration
+- `--verbose` - Enable verbose logging
+
 ### Python SDK (headless)
 
 Use Ripperdoc without the terminal UI via the new Python SDK. See [docs/SDK_USAGE.md](docs/SDK_USAGE.md) for examples of the one-shot `query` helper and the session-based `RipperdocClient`. 中文指南见 [docs/SDK_USAGE_CN.md](docs/SDK_USAGE_CN.md)。
@@ -137,38 +146,67 @@ See the [examples/](examples/) directory for complete SDK usage examples.
 
 ### Safe Mode Permissions
 
-Safe mode is the default. Use `--unsafe` to skip permission prompts. Choose `a`/`always` to allow a tool for the current session (not persisted across sessions).
+Safe mode is enabled by default. When prompted:
+- Type `y` or `yes` to allow a single operation
+- Type `a` or `always` to allow all operations of that type for the session
+- Type `n` or `no` to deny the operation
+
+Use `--yolo` flag to skip all permission prompts:
+```bash
+ripperdoc --yolo
+```
 
 ### Agent Skills
 
 Extend Ripperdoc with reusable Skill bundles:
 
-- Personal skills live in `~/.ripperdoc/skills/<skill-name>/SKILL.md`
-- Project skills live in `.ripperdoc/skills/<skill-name>/SKILL.md` and can be checked into git
-- Each `SKILL.md` starts with YAML frontmatter (`name`, `description`, optional `allowed-tools`, `model`, `max-thinking-tokens`, `disable-model-invocation`) followed by the instructions; add supporting files alongside it
-- Model and max-thinking-token hints from skills are applied automatically for the rest of the session after you load them with the `Skill` tool
-- Ripperdoc exposes skill names/descriptions in the system prompt and loads full content on demand via the `Skill` tool
+- **Personal skills**: `~/.ripperdoc/skills/<skill-name>/SKILL.md`
+- **Project skills**: `.ripperdoc/skills/<skill-name>/SKILL.md` (can be checked into git)
+- Each `SKILL.md` starts with YAML frontmatter:
+  - `name` - Skill identifier
+  - `description` - What the skill does
+  - `allowed-tools` (optional) - Restrict which tools the skill can use
+  - `model` (optional) - Suggest a specific model for this skill
+  - `max-thinking-tokens` (optional) - Control thinking budget
+  - `disable-model-invocation` (optional) - Use skill without calling the model
+- Add supporting files alongside `SKILL.md` as needed
+- Skills are auto-discovered and loaded on demand via the `Skill` tool
+
+**Built-in skills:** PDF manipulation (`pdf`), PowerPoint (`pptx`), Excel (`xlsx`)
 
 ## Examples
 
 ### Code Analysis
 ```
 > Can you explain what this function does?
+> Find all references to the `parse_config` function
 ```
 
 ### File Operations
 ```
 > Read the main.py file and suggest improvements
+> Create a new component called UserProfile.tsx
+> Update all imports to use the new package structure
 ```
 
 ### Code Generation
 ```
 > Create a new Python script that implements a REST API client
+> Generate unit tests for the auth module
+> Add error handling to the database connection code
 ```
 
 ### Project Navigation
 ```
 > Show me all the Python files in the project
+> Find where the user authentication logic is implemented
+> List all API endpoints in the project
+```
+
+### MCP Integration
+```
+> What MCP servers are available?
+> Query the context7 documentation for React hooks
 ```
 
 ## Development

{ripperdoc-0.2.9 → ripperdoc-0.3.0}/README.md

@@ -56,27 +56,22 @@ pip install git+https://github.com/quantmew/ripperdoc.git
 Or install from source:
 ```bash
 # Clone the repository
-git clone <repository-url>
-cd Ripperdoc
+git clone https://github.com/quantmew/ripperdoc.git
+cd ripperdoc
 
 # Install from source
 pip install -e .
 ```
 
-### Configuration
 
-Set your API key as an environment variable:
-```bash
-export OPENAI_API_KEY="your-api-key-here"
-# or for Anthropic Claude
-export ANTHROPIC_API_KEY="your-api-key-here"
-```
 
 ## Usage
 
 ### Interactive Mode (Recommended)
 ```bash
 ripperdoc
+# or use the short alias
+rd
 ```
 
 This launches an interactive session where you can:
@@ -85,6 +80,13 @@ This launches an interactive session where you can:
 - Execute commands
 - Navigate and explore files
 
+**Options:**
+- `--yolo` - Skip permission prompts (safe mode is on by default)
+- `--model <model_name>` - Specify a model (e.g., `claude-sonnet-4-20250514`, `gpt-4o`)
+- `--tools <tool_list>` - Filter available tools (comma-separated, or "" for none)
+- `--no-mcp` - Disable MCP server integration
+- `--verbose` - Enable verbose logging
+
 ### Python SDK (headless)
 
 Use Ripperdoc without the terminal UI via the new Python SDK. See [docs/SDK_USAGE.md](docs/SDK_USAGE.md) for examples of the one-shot `query` helper and the session-based `RipperdocClient`. 中文指南见 [docs/SDK_USAGE_CN.md](docs/SDK_USAGE_CN.md)。
@@ -100,38 +102,67 @@ See the [examples/](examples/) directory for complete SDK usage examples.
 
 ### Safe Mode Permissions
 
-Safe mode is the default. Use `--unsafe` to skip permission prompts. Choose `a`/`always` to allow a tool for the current session (not persisted across sessions).
+Safe mode is enabled by default. When prompted:
+- Type `y` or `yes` to allow a single operation
+- Type `a` or `always` to allow all operations of that type for the session
+- Type `n` or `no` to deny the operation
+
+Use `--yolo` flag to skip all permission prompts:
+```bash
+ripperdoc --yolo
+```
 
 ### Agent Skills
 
 Extend Ripperdoc with reusable Skill bundles:
 
-- Personal skills live in `~/.ripperdoc/skills/<skill-name>/SKILL.md`
-- Project skills live in `.ripperdoc/skills/<skill-name>/SKILL.md` and can be checked into git
-- Each `SKILL.md` starts with YAML frontmatter (`name`, `description`, optional `allowed-tools`, `model`, `max-thinking-tokens`, `disable-model-invocation`) followed by the instructions; add supporting files alongside it
-- Model and max-thinking-token hints from skills are applied automatically for the rest of the session after you load them with the `Skill` tool
-- Ripperdoc exposes skill names/descriptions in the system prompt and loads full content on demand via the `Skill` tool
+- **Personal skills**: `~/.ripperdoc/skills/<skill-name>/SKILL.md`
+- **Project skills**: `.ripperdoc/skills/<skill-name>/SKILL.md` (can be checked into git)
+- Each `SKILL.md` starts with YAML frontmatter:
+  - `name` - Skill identifier
+  - `description` - What the skill does
+  - `allowed-tools` (optional) - Restrict which tools the skill can use
+  - `model` (optional) - Suggest a specific model for this skill
+  - `max-thinking-tokens` (optional) - Control thinking budget
+  - `disable-model-invocation` (optional) - Use skill without calling the model
+- Add supporting files alongside `SKILL.md` as needed
+- Skills are auto-discovered and loaded on demand via the `Skill` tool
+
+**Built-in skills:** PDF manipulation (`pdf`), PowerPoint (`pptx`), Excel (`xlsx`)
 
 ## Examples
 
 ### Code Analysis
 ```
 > Can you explain what this function does?
+> Find all references to the `parse_config` function
 ```
 
 ### File Operations
 ```
 > Read the main.py file and suggest improvements
+> Create a new component called UserProfile.tsx
+> Update all imports to use the new package structure
 ```
 
 ### Code Generation
 ```
 > Create a new Python script that implements a REST API client
+> Generate unit tests for the auth module
+> Add error handling to the database connection code
 ```
 
 ### Project Navigation
 ```
 > Show me all the Python files in the project
+> Find where the user authentication logic is implemented
+> List all API endpoints in the project
+```
+
+### MCP Integration
+```
+> What MCP servers are available?
+> Query the context7 documentation for React hooks
 ```
 
 ## Development

{ripperdoc-0.2.9 → ripperdoc-0.3.0}/pyproject.toml

@@ -32,10 +32,11 @@ dependencies = [
     "aiofiles>=23.0.0",
     "prompt-toolkit>=3.0.0",
     "PyYAML>=6.0.0",
-    "mcp[cli]>=1.22.0",
+    "mcp[cli]>=1.25.0",  # Fixed stdio_client async generator cleanup issue
     "json_repair>=0.54.2",
     "tiktoken>=0.7.0",
     "google-genai>=0.3.0",
+    "charset-normalizer>=3.0.0",
 ]
 
 [project.optional-dependencies]
@@ -46,6 +47,9 @@ dev = [
     "black>=23.0.0",
     "ruff>=0.1.0",
 ]
+anthropic = ["anthropic>=0.39.0"]
+openai = ["openai>=1.0.0"]
+gemini = ["google-genai>=0.3.0"]
 
 [project.scripts]
 ripperdoc = "ripperdoc.cli.cli:main"
@@ -68,7 +72,7 @@ warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true
 files = ["ripperdoc"]
-exclude = ["^tests/"]
+exclude = ["^tests/", "^setup\\.py$"]
 
 [tool.ruff]
 line-length = 100

{ripperdoc-0.2.9 → ripperdoc-0.3.0}/ripperdoc/__init__.py

@@ -1,3 +1,3 @@
 """Ripperdoc - AI-powered coding agent."""
 
-__version__ = "0.2.9"
+__version__ = "0.3.0"