Ripperdoc

Introduction

What is Ripperdoc and why use it

Ripperdoc is an open-source, extensible AI coding agent that runs in your terminal. It's designed to help you write, refactor, and understand code through natural language conversations.

  • Multi-Model Support: Works with Anthropic Claude, OpenAI, DeepSeek, Gemini, and any OpenAI-compatible API including local models
  • Terminal Native: Rich CLI interface with syntax highlighting, streaming responses, and real-time feedback
  • Extensible: Customize with hooks, skills, subagents, and MCP (Model Context Protocol) integration
  • Privacy First: Runs locally on your machine with your API keys
  • Open Source: Apache 2.0 licensed, fully transparent and customizable

Powerful Tools

Ripperdoc comes with 30+ built-in tools for:

  • File operations (read, edit, write, multi-edit, notebook edit)
  • Code search (glob patterns, regex grep, LSP integration)
  • Shell command execution (with sandbox and background support)
  • Jupyter notebook editing
  • Task planning and tracking with persistent task graph
  • Team coordination and multi-agent workflows
  • Remote control bridge for distributed agent architectures

Intelligent Permissions

A sophisticated permission system that:

  • Prompts for approval on potentially destructive operations
  • Supports YOLO mode for trusted workflows
  • Allows fine-grained permission rules

Session Management

  • Persistent conversation history
  • Resume interrupted sessions
  • Automatic context compaction
  • Cost and token tracking
pip install git+https://github.com/quantmew/ripperdoc.git
ripperdoc --help

See the Installation guide for detailed setup instructions, or jump to the Quickstart to start using Ripperdoc immediately.

On this page