Ralph for Claude Code

Ralph for Claude Code

[](https://github.com/frankbria/ralph-claude-code/actions/workflows/test.yml) [](LICENSE)

[](https://github.com/frankbria/ralph-claude-code/issues) [](https://github.com/hesreallyhim/awesome-claude-code) [](https://x.com/FrankBria18044)

**Autonomous AI development loop with intelligent exit detection and rate limiting**

Ralph is an implementation of the Geoffrey Huntley's technique for Claude Code that enables continuous autonomous development cycles he named after [Ralph Wiggum](https://ghuntley.com/ralph/). It enables continuous autonomous development cycles where Claude Code iteratively improves your project until completion, with built-in safeguards to prevent infinite loops and API overuse.

**Install once, use everywhere** - Ralph becomes a global command available in any directory.

Project Status

**Version**: v0.11.5 - Active Development **Core Features**: Working and tested **Test Coverage**: 566 tests, 100% pass rate

What's Working Now

• Autonomous development loops with intelligent exit detection
• Dual-condition exit gate: Requires BOTH completion indicators AND explicit EXIT_SIGNAL
• Rate limiting with hourly reset (100 calls/hour, configurable)
• Circuit breaker with advanced error detection (prevents runaway loops)
• Response analyzer with semantic understanding and two-stage error filtering
• JSON output format support with automatic fallback to text parsing
• Session continuity with --resume flag for context preservation (no session hijacking)
• Session expiration with configurable timeout (default: 24 hours)
• Modern CLI flags: --output-format, --allowed-tools, --no-continue
• Interactive project enablement with ralph-enable wizard
• .ralphrc configuration file for project settings
• Live streaming output with --live flag for real-time Claude Code visibility
• Multi-line error matching for accurate stuck loop detection
• 5-hour API limit handling with user prompts

...