codereaper
AI Dead Code Elimination MCP for Cursor
Documentation
CodeReaper
CodeReaper is an AI-driven MCP tool for Cursor that finds and removes dead JavaScript by exploring real UIs and capturing V8 coverage.
Key Features
- Autonomous UI exploration via the Index browser agent
- V8 precise coverage to identify zero-execution functions
- Risk scoring and removal recommendations
- Patch generation and optional verification replay
- MCP integration for Cursor workflows
Quick Install
pip install codereaper
playwright install chromium
codereaperWhen you first run `codereaper`, it prompts for your Gemini API key and saves it in your global `~/.cursor/mcp.json` so Cursor can invoke it later.
Alternative Install
# pipx
pipx run codereaperPrerequisites
- Python 3.11+
- Playwright Chromium (installed via `playwright install chromium`)
- A Gemini API key (or OpenAI / Anthropic if you change providers)
Quick Start
1. Install and run `codereaper` (it updates `~/.cursor/mcp.json`)
2. Restart Cursor
3. Ask the assistant:
> "Find dead JavaScript code on http://localhost:3000"
Usage
Command:
codereaperExample scan with local source mapping:
> "Find dead code on http://localhost:3000, source is in ./test_site"
MCP Tools
| Tool | Description |
|---|---|
| `find_dead_code` | Full pipeline: scan + analyze. Returns dead-code report with file paths, line numbers, risk scores, and removal recommendations. |
| `scan_website` | Scan only (no analysis). Returns scan_id for later use. |
| `analyze_dead_code` | Analyze a completed scan. Takes scan_id. |
| `generate_patches` | Generate unified diffs to remove dead code (conservative / balanced / aggressive). |
| `get_patch_diff` | Retrieve the combined diff for a patch. |
| `apply_patch` | Apply a patch to source files (stores snapshots for rollback). |
| `verify_patch` | Re-run the browser agent to check for regressions after patching. |
| `rollback_patch` | Restore original files from pre-patch snapshots. |
| `list_scans` | List recent scans. |
| `get_scan_status` | Get detailed status of a scan. |
Troubleshooting
- If the browser doesn’t open, install Chromium: `playwright install chromium`
- If the scan fails with key errors, ensure `GEMINI_API_KEY` exists in `~/.cursor/mcp.json`
- If local pages don’t load, confirm your dev server is running and reachable
- If Gemini rate limits hit, retry after the quota window resets
Update
- 02-09-2026: v0.2.3 release
Issues & Feedback
Open an issue with steps to reproduce and logs if possible. Feedback and suggestions are welcome.
Frequently asked questions
What is codereaper?
codereaper is AI Dead Code Elimination MCP for Cursor
How do I install codereaper?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is codereaper open source?
Yes — it is hosted on GitHub at https://github.com/kaldonia-labs/codereaper.
Related MCP tools
Cognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.
Automate browser based workflows with AI
Hindsight: Agent Memory That Learns
A privacy-first app that strips AI watermarks from content you own.
Agent framework and applications built upon Qwen>=3.0, featuring Function Calling, MCP, Code Interpreter, RAG, Chrome extension, etc.
The power of Claude Code / GeminiCLI / CodexCLI + [Gemini / OpenAI / OpenRouter / Azure / Grok / Ollama / Custom Model / All Of The Above] working as one.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP