ripperdoc 0.2.7__tar.gz → 0.2.8__tar.gz

{ripperdoc-0.2.7 → ripperdoc-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ripperdoc
-Version: 0.2.7
+Version: 0.2.8
 Summary: AI-powered terminal assistant for coding tasks
 Author: Ripperdoc Team
 License: Apache-2.0
@@ -35,9 +35,28 @@ Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Dynamic: license-file
 
-# Ripperdoc - AI-Powered Terminal Assistant
+<div align="center">
 
-Ripperdoc is an AI-powered terminal assistant for coding tasks, providing an interactive interface for AI-assisted development, file management, and command execution.
+# Ripperdoc
+
+_an open-source, extensible AI coding agent that runs in your terminal_
+
+<p align="center">
+  <a href="https://opensource.org/licenses/Apache-2.0">
+    <img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg">
+  </a>
+  <a href="https://www.python.org/downloads/">
+    <img src="https://img.shields.io/badge/python-3.10+-blue.svg">
+  </a>
+  <a href="https://github.com/quantmew/ripperdoc/stargazers">
+    <img src="https://img.shields.io/github/stars/quantmew/ripperdoc.svg" alt="GitHub stars">
+  </a>
+</p>
+</div>
+
+Ripperdoc is your on-machine AI coding assistant, similar to [Claude Code](https://claude.com/claude-code), [Codex](https://github.com/openai/codex), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Aider](https://github.com/paul-gauthier/aider), and [Goose](https://github.com/block/goose). It can write code, refactor projects, execute shell commands, and manage files - all through natural language conversations in your terminal.
+
+Designed for maximum flexibility, Ripperdoc works with **any LLM** (Anthropic Claude, OpenAI, DeepSeek, local models via OpenAI-compatible APIs), supports **custom hooks** to intercept and control tool execution, and offers both an interactive CLI and a **Python SDK** for headless automation.
 
 [中文文档](README_CN.md) | [Contributing](CONTRIBUTING.md) | [Documentation](docs/)
 
@@ -60,6 +79,8 @@ Ripperdoc is an AI-powered terminal assistant for coding tasks, providing an int
 - **MCP Server Support** - Integration with Model Context Protocol servers
 - **Session Management** - Persistent session history and usage tracking
 - **Jupyter Notebook Support** - Edit .ipynb files directly
+- **Hooks System** - Execute custom scripts at lifecycle events with decision control
+- **Custom Commands** - Define reusable slash commands with parameter substitution
 
 ## Installation
 

{ripperdoc-0.2.7 → ripperdoc-0.2.8}/README.md

@@ -1,6 +1,25 @@
-# Ripperdoc - AI-Powered Terminal Assistant
+<div align="center">
 
-Ripperdoc is an AI-powered terminal assistant for coding tasks, providing an interactive interface for AI-assisted development, file management, and command execution.
+# Ripperdoc
+
+_an open-source, extensible AI coding agent that runs in your terminal_
+
+<p align="center">
+  <a href="https://opensource.org/licenses/Apache-2.0">
+    <img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg">
+  </a>
+  <a href="https://www.python.org/downloads/">
+    <img src="https://img.shields.io/badge/python-3.10+-blue.svg">
+  </a>
+  <a href="https://github.com/quantmew/ripperdoc/stargazers">
+    <img src="https://img.shields.io/github/stars/quantmew/ripperdoc.svg" alt="GitHub stars">
+  </a>
+</p>
+</div>
+
+Ripperdoc is your on-machine AI coding assistant, similar to [Claude Code](https://claude.com/claude-code), [Codex](https://github.com/openai/codex), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Aider](https://github.com/paul-gauthier/aider), and [Goose](https://github.com/block/goose). It can write code, refactor projects, execute shell commands, and manage files - all through natural language conversations in your terminal.
+
+Designed for maximum flexibility, Ripperdoc works with **any LLM** (Anthropic Claude, OpenAI, DeepSeek, local models via OpenAI-compatible APIs), supports **custom hooks** to intercept and control tool execution, and offers both an interactive CLI and a **Python SDK** for headless automation.
 
 [中文文档](README_CN.md) | [Contributing](CONTRIBUTING.md) | [Documentation](docs/)
 
@@ -23,6 +42,8 @@ Ripperdoc is an AI-powered terminal assistant for coding tasks, providing an int
 - **MCP Server Support** - Integration with Model Context Protocol servers
 - **Session Management** - Persistent session history and usage tracking
 - **Jupyter Notebook Support** - Edit .ipynb files directly
+- **Hooks System** - Execute custom scripts at lifecycle events with decision control
+- **Custom Commands** - Define reusable slash commands with parameter substitution
 
 ## Installation
 

{ripperdoc-0.2.7 → ripperdoc-0.2.8}/ripperdoc/__init__.py

@@ -1,3 +1,3 @@
 """Ripperdoc - AI-powered coding agent."""
 
-__version__ = "0.2.7"
+__version__ = "0.2.8"

{ripperdoc-0.2.7 → ripperdoc-0.2.8}/ripperdoc/cli/cli.py

@@ -22,6 +22,7 @@ from ripperdoc.core.default_tools import get_default_tools
 from ripperdoc.core.query import query, QueryContext
 from ripperdoc.core.system_prompt import build_system_prompt
 from ripperdoc.core.skills import build_skill_summary, load_all_skills
+from ripperdoc.core.hooks.manager import hook_manager
 from ripperdoc.utils.messages import create_user_message
 from ripperdoc.utils.memory import build_memory_instructions
 from ripperdoc.core.permissions import make_permission_checker
@@ -70,6 +71,10 @@ async def run_query(
     project_path = Path.cwd()
     can_use_tool = make_permission_checker(project_path, safe_mode) if safe_mode else None
 
+    # Initialize hook manager
+    hook_manager.set_project_dir(project_path)
+    hook_manager.set_session_id(session_id)
+
     # Create initial user message
     from ripperdoc.utils.messages import UserMessage, AssistantMessage, ProgressMessage
 

ripperdoc-0.2.8/ripperdoc/cli/commands/__init__.py

@@ -0,0 +1,147 @@
+"""Slash command registry with custom command support."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Dict, List, Optional, Tuple, Union
+
+from .base import SlashCommand
+from .agents_cmd import command as agents_command
+from .clear_cmd import command as clear_command
+from .compact_cmd import command as compact_command
+from .config_cmd import command as config_command
+from .cost_cmd import command as cost_command
+from .context_cmd import command as context_command
+from .doctor_cmd import command as doctor_command
+from .exit_cmd import command as exit_command
+from .help_cmd import command as help_command
+from .hooks_cmd import command as hooks_command
+from .memory_cmd import command as memory_command
+from .mcp_cmd import command as mcp_command
+from .models_cmd import command as models_command
+from .permissions_cmd import command as permissions_command
+from .resume_cmd import command as resume_command
+from .tasks_cmd import command as tasks_command
+from .status_cmd import command as status_command
+from .todos_cmd import command as todos_command
+from .tools_cmd import command as tools_command
+
+from ripperdoc.core.custom_commands import (
+    CustomCommandDefinition,
+    load_all_custom_commands,
+    find_custom_command,
+    expand_command_content,
+)
+
+
+def _build_registry(commands: List[SlashCommand]) -> Dict[str, SlashCommand]:
+    """Map command names and aliases to SlashCommand entries."""
+    registry: Dict[str, SlashCommand] = {}
+    for cmd in commands:
+        registry[cmd.name] = cmd
+        for alias in cmd.aliases:
+            registry[alias] = cmd
+    return registry
+
+
+ALL_COMMANDS: List[SlashCommand] = [
+    help_command,
+    clear_command,
+    config_command,
+    tools_command,
+    models_command,
+    exit_command,
+    status_command,
+    doctor_command,
+    memory_command,
+    permissions_command,
+    tasks_command,
+    todos_command,
+    mcp_command,
+    hooks_command,
+    cost_command,
+    context_command,
+    compact_command,
+    resume_command,
+    agents_command,
+]
+
+COMMAND_REGISTRY: Dict[str, SlashCommand] = _build_registry(ALL_COMMANDS)
+
+# Cache for custom commands
+_custom_commands_cache: Optional[Tuple[Path, List[CustomCommandDefinition]]] = None
+
+
+def _get_custom_commands(project_path: Optional[Path] = None) -> List[CustomCommandDefinition]:
+    """Get custom commands with caching."""
+    global _custom_commands_cache
+    current_path = (project_path or Path.cwd()).resolve()
+
+    # Return cached commands if same project
+    if _custom_commands_cache and _custom_commands_cache[0] == current_path:
+        return _custom_commands_cache[1]
+
+    # Load and cache
+    result = load_all_custom_commands(project_path=current_path)
+    _custom_commands_cache = (current_path, result.commands)
+    return result.commands
+
+
+def refresh_custom_commands(project_path: Optional[Path] = None) -> List[CustomCommandDefinition]:
+    """Force reload custom commands."""
+    global _custom_commands_cache
+    _custom_commands_cache = None
+    return _get_custom_commands(project_path)
+
+
+def list_slash_commands() -> List[SlashCommand]:
+    """Return the ordered list of base slash commands (no aliases)."""
+    return ALL_COMMANDS
+
+
+def list_custom_commands(project_path: Optional[Path] = None) -> List[CustomCommandDefinition]:
+    """Return all loaded custom commands."""
+    return _get_custom_commands(project_path)
+
+
+def get_slash_command(name: str) -> SlashCommand | None:
+    """Return a built-in command by name or alias."""
+    return COMMAND_REGISTRY.get(name)
+
+
+def get_custom_command(
+    name: str, project_path: Optional[Path] = None
+) -> CustomCommandDefinition | None:
+    """Return a custom command by name."""
+    commands = _get_custom_commands(project_path)
+    return next((cmd for cmd in commands if cmd.name == name), None)
+
+
+def slash_command_completions(
+    project_path: Optional[Path] = None,
+) -> List[Tuple[str, Union[SlashCommand, CustomCommandDefinition]]]:
+    """Return (name, command) pairs for completion including aliases and custom commands."""
+    completions: List[Tuple[str, Union[SlashCommand, CustomCommandDefinition]]] = []
+
+    # Add built-in commands
+    completions.extend(list(COMMAND_REGISTRY.items()))
+
+    # Add custom commands
+    custom_cmds = _get_custom_commands(project_path)
+    for cmd in custom_cmds:
+        completions.append((cmd.name, cmd))
+
+    return completions
+
+
+__all__ = [
+    "SlashCommand",
+    "CustomCommandDefinition",
+    "list_slash_commands",
+    "list_custom_commands",
+    "get_slash_command",
+    "get_custom_command",
+    "slash_command_completions",
+    "refresh_custom_commands",
+    "expand_command_content",
+]

ripperdoc-0.2.8/ripperdoc/cli/commands/help_cmd.py

@@ -0,0 +1,30 @@
+from typing import Any
+from .base import SlashCommand
+
+
+def _handle(ui: Any, _: str) -> bool:
+    ui.console.print("\n[bold]Available Slash Commands:[/bold]")
+    for cmd in ui.command_list:
+        alias_text = f" (aliases: {', '.join(cmd.aliases)})" if cmd.aliases else ""
+        ui.console.print(f"  /{cmd.name:<12} - {cmd.description}{alias_text}")
+
+    # Show custom commands if any
+    custom_cmds = getattr(ui, "_custom_command_list", [])
+    if custom_cmds:
+        ui.console.print("\n[bold]Custom Commands:[/bold]")
+        for cmd in sorted(custom_cmds, key=lambda c: c.name):
+            hint = f" {cmd.argument_hint}" if cmd.argument_hint else ""
+            location = f" ({cmd.location.value})" if cmd.location else ""
+            ui.console.print(f"  /{cmd.name:<12}{hint} - {cmd.description}{location}")
+
+    return True
+
+
+command = SlashCommand(
+    name="help",
+    description="Show available slash commands",
+    handler=_handle,
+)
+
+
+__all__ = ["command"]