Code Reaper

CodeReaper

O CodeReaper é uma ferramenta MCP baseada em IA para o Cursor que encontra e remove JavaScript morto explorando UIs reais e capturando a cobertura do V8.

Principais Recursos

• Exploração autônoma de UI por meio do agente de navegador Index
• Cobertura precisa do V8 para identificar funções com execução zero
• Pontuação de risco e recomendações de remoção
• Geração de patches e replay de verificação opcional
• Integração MCP para fluxos de trabalho do Cursor

Instalação Rápida

pip install codereaper
playwright install chromium
codereaper

Na primeira vez que você executar codereaper, ele solicitará sua chave de API do Gemini e a salvará no seu ~/.cursor/mcp.json global para que o Cursor possa invocá-lo posteriormente.

Instalação Alternativa

# pipx
pipx run codereaper

Pré-requisitos

• Python 3.11+
• Playwright Chromium (instalado via playwright install chromium)
• Uma chave de API do Gemini (ou OpenAI / Anthropic se você mudar de provedor)

Início Rápido

1. Instale e execute codereaper (ele atualiza ~/.cursor/mcp.json)
2. Reinicie o Cursor
3. Pergunte ao assistente:

   "Encontre código JavaScript morto em http://localhost:3000"

Uso

Comando:

codereaper

Exemplo de varredura com mapeamento de fonte local:

"Encontre código morto em http://localhost:3000, a fonte está em ./test_site"

Ferramentas MCP

Ferramenta	Descrição
find_dead_code	Pipeline completo: varredura + análise. Retorna relatório de código morto com caminhos de arquivo, números de linha, pontuações de risco e recomendações de remoção.
scan_website	Somente varredura (sem análise). Retorna scan_id para uso posterior.
analyze_dead_code	Analisa uma varredura concluída. Recebe scan_id.
generate_patches	Gera diffs unificados para remover código morto (conservador / equilibrado / agressivo).
get_patch_diff	Recupera o diff combinado de um patch.
apply_patch	Aplica um patch aos arquivos de origem (armazena snapshots para rollback).
verify_patch	Reexecuta o agente de navegador para verificar regressões após o patch.
rollback_patch	Restaura arquivos originais a partir de snapshots pré-patch.
list_scans	Lista varreduras recentes.
get_scan_status	Obtém o status detalhado de uma varredura.

Solução de Problemas

• Se o navegador não abrir, instale o Chromium: playwright install chromium
• Se a varredura falhar com erros de chave, garanta que GEMINI_API_KEY exista em ~/.cursor/mcp.json
• Se páginas locais não carregarem, confirme se o seu servidor de desenvolvimento está em execução e acessível
• Se os limites de taxa do Gemini forem atingidos, tente novamente após a janela de cota ser redefinida

Atualização

• 02-09-2026: lançamento v0.2.3

Problemas e Feedback

Abra um issue com etapas para reproduzir e logs, se possível. Feedback e sugestões são bem-vindos.