Code Reaper

CodeReaper

CodeReaper es una herramienta MCP impulsada por IA para Cursor que encuentra y elimina JavaScript muerto explorando interfaces reales y capturando cobertura V8.

Características principales

• Exploración autónoma de la interfaz de usuario mediante el agente de navegador Index
• Cobertura precisa de V8 para identificar funciones con cero ejecución
• Puntuación de riesgo y recomendaciones de eliminación
• Generación de parches y reproducción de verificación opcional
• Integración MCP para flujos de trabajo de Cursor

Instalación rápida

pip install codereaper
playwright install chromium
codereaper

Cuando ejecutes codereaper por primera vez, te pedirá tu clave de API de Gemini y la guardará en tu ~/.cursor/mcp.json global para que Cursor pueda invocarla más tarde.

Instalación alternativa

# pipx
pipx run codereaper

Requisitos previos

• Python 3.11+
• Playwright Chromium (instalado mediante playwright install chromium)
• Una clave de API de Gemini (o OpenAI / Anthropic si cambias de proveedor)

Inicio rápido

1. Instala y ejecuta codereaper (actualiza ~/.cursor/mcp.json)
2. Reinicia Cursor
3. Pregunta al asistente:

   "Encuentra código JavaScript muerto en http://localhost:3000"

Uso

Comando:

codereaper

Ejemplo de escaneo con mapeo de fuente local:

"Encuentra código muerto en http://localhost:3000, la fuente está en ./test_site"

Herramientas MCP

Herramienta	Descripción
find_dead_code	Pipeline completo: escaneo + análisis. Devuelve un informe de código muerto con rutas de archivo, números de línea, puntuaciones de riesgo y recomendaciones de eliminación.
scan_website	Solo escaneo (sin análisis). Devuelve scan_id para uso posterior.
analyze_dead_code	Analiza un escaneo completado. Toma scan_id.
generate_patches	Genera diffs unificados para eliminar código muerto (conservador / equilibrado / agresivo).
get_patch_diff	Recupera el diff combinado de un parche.
apply_patch	Aplica un parche a los archivos fuente (almacena instantáneas para revertir).
verify_patch	Vuelve a ejecutar el agente de navegador para comprobar regresiones después de aplicar el parche.
rollback_patch	Restaura los archivos originales desde las instantáneas previas al parche.
list_scans	Lista los escaneos recientes.
get_scan_status	Obtén el estado detallado de un escaneo.

Solución de problemas

• Si el navegador no se abre, instala Chromium: playwright install chromium
• Si el escaneo falla con errores de clave, asegúrate de que GEMINI_API_KEY exista en ~/.cursor/mcp.json
• Si las páginas locales no cargan, confirma que tu servidor de desarrollo esté en ejecución y sea accesible
• Si se alcanzan los límites de velocidad de Gemini, reintenta después de que se restablezca la ventana de cuota

Actualización

• 02-09-2026: lanzamiento v0.2.3

Problemas y comentarios

Abre un issue con pasos para reproducir y registros si es posible. Los comentarios y sugerencias son bienvenidos.