Sobre o projeto

Ralph para Claude Code é uma ferramenta de código aberto que implementa a técnica "Ralph" de Geoffrey Huntley, permitindo ciclos contínuos de desenvolvimento autônomo onde o Claude Code melhora iterativamente um projeto até a conclusão. Ele é instalado globalmente e fornece comandos como `ralph`, `ralph-monitor`, `ralph-setup`, `ralph-enable`, `ralph-import`, `ralph-queue` e `ralph-migrate`. As capacidades principais incluem um loop de desenvolvimento autônomo com uma porta de saída de dupla condição, exigindo tanto indicadores de conclusão quanto um EXIT_SIGNAL explícito, limitação de taxa (100 chamadas/hora, configurável) e um disjuntor com detecção avançada de erros para evitar loops descontrolados. A continuidade da sessão é preservada entre iterações via `--resume`, com expiração de sessão configurável (padrão de 24 horas). A saída de streaming ao vivo (`--live`) e a integração com tmux fornecem monitoramento em tempo real do status do loop, progresso e logs. O assistente interativo `ralph-enable` detecta automaticamente o tipo de projeto (TypeScript, Python, Rust, Go) e o framework (Next.js, FastAPI, Django), e então importa tarefas de beads, Issues do GitHub ou documentos PRD. A importação de issues do GitHub suporta filtros de metadados (rótulos, título, atribuído, marco, estado) com estratégias de seleção primeira/interativa/prioritária e uma avaliação de completude (pontuação de 0-100) que gera automaticamente planos de implementação para issues esparsas. A importação de PRD converte documentos Markdown, texto, JSON, Word e PDF para o formato Ralph. Recursos adicionais incluem execução em sandbox na nuvem Docker e E2B com limites de recursos e rastreamento de custos, arquivos de configuração `.ralphrc`, rotação de logs (10MB, 4 arquivos), modo de simulação, rastreamento de métricas via `ralph-stats`, notificações de desktop, branches de backup automáticas no git com reversão e um pipeline de CI/CD com GitHub Actions. O projeto está na versão v0.11.5 com 784 testes passando e desenvolvimento ativo; uma abstração de agente multi-provedor está em andamento para desacoplar do Claude Code e suportar outras CLIs de codificação headless, como Codex, Gemini e Copilot.