프로젝트 소개

Ralph for Claude Code는 Geoffrey Huntley의 "Ralph" 기법을 구현한 오픈소스 도구로, Claude Code가 프로젝트를 완료할 때까지 반복적으로 개선하는 지속적인 자율 개발 주기를 가능하게 합니다. 전역적으로 설치되며 `ralph`, `ralph-monitor`, `ralph-setup`, `ralph-enable`, `ralph-import`, `ralph-queue`, `ralph-migrate`와 같은 명령을 제공합니다. 핵심 기능에는 완료 표시와 명시적 EXIT_SIGNAL을 모두 요구하는 이중 조건 종료 게이트, 속도 제한(기본 100회/시간, 구성 가능), 그리고 폭주 루프를 방지하기 위한 고급 오류 감지 기능이 있는 회로 차단기를 갖춘 자율 개발 루프가 포함됩니다. 세션 연속성은 `--resume`을 통해 반복 간에 유지되며, 세션 만료 시간(기본 24시간)을 구성할 수 있습니다. 실시간 스트리밍 출력(`--live`)과 tmux 통합은 루프 상태, 진행 상황, 로그를 실시간으로 모니터링할 수 있게 해줍니다. 대화형 `ralph-enable` 마법사는 프로젝트 유형(TypeScript, Python, Rust, Go)과 프레임워크(Next.js, FastAPI, Django)를 자동 감지한 다음, beads, GitHub Issues 또는 PRD 문서에서 작업을 가져옵니다. GitHub 이슈 가져오기는 메타데이터 필터(레이블, 제목, 담당자, 마일스톤, 상태)를 지원하며, 첫 번째/대화형/우선순위 선택 전략과 완전성 평가(0-100점)를 통해 희소한 이슈에 대한 구현 계획을 자동 생성합니다. PRD 가져오기는 Markdown, 텍스트, JSON, Word, PDF 문서를 Ralph 형식으로 변환합니다. 추가 기능으로는 리소스 제한 및 비용 추적이 있는 Docker 및 E2B 클라우드 샌드박스 실행, `.ralphrc` 구성 파일, 로그 순환(10MB, 4개 아카이브), 드라이런 모드, `ralph-stats`를 통한 메트릭 추적, 데스크톱 알림, 롤백이 가능한 자동 git 백업 브랜치, GitHub Actions를 사용한 CI/CD 파이프라인이 있습니다. 이 프로젝트는 v0.11.5이며 784개의 통과 테스트와 활발한 개발이 진행 중입니다. Claude Code에서 분리하고 Codex, Gemini, Copilot과 같은 다른 헤드리스 코딩 CLI를 지원하기 위한 다중 제공자 에이전트 추상화가 진행 중입니다.