Ralph Claude Code
Autonomous AI development loop for Claude Code with intelligent exit detection
Rating
Votes
0
score
Downloads
0
total
Price
Free
Access token required
Works With
About
Ralph for Claude Code
](https://github.com/frankbria/ralph-claude-code/actions/workflows/test.yml) [
](https://github.com/frankbria/ralph-claude-code/issues) [ [](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. 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
- tmux integration for live monitoring
- PRD import functionality
- CI/CD pipeline with GitHub Actions
- Dedicated uninstall script for clean removal
Recent Improvements
v0.11.5 - Community Bug Fixes (latest)
- Fixed API limit false positive: Timeout (exit code 124) no longer misidentified as API 5-hour limit (#183)
- Three-layer API limit detection: timeout guard → structural JSON (
rate_limit_event) → filtered text fallback - Unattended mode: API limit prompt now auto-waits on timeout instead of exiting
- Fixed bash 3.x compatibility:
${,,}lowercase substitution replaced with POSIXtr(#187) - Added 8 new tests for API limit detection (548 → 566 tests)
Don't lose this
Three weeks from now, you'll want Ralph Claude Code again. Will you remember where to find it?
Save it to your library and the next time you need Ralph Claude Code, it’s one tap away — from any AI app you use. Group it into a bench with the rest of the team for that kind of task and you can pull the whole stack at once.
⚡ Pro tip for geeks: add a-gnt 🤵🏻♂️ as a custom connector in Claude or a custom GPT in ChatGPT — one click and your library is right there in the chat. Or, if you’re in an editor, install the a-gnt MCP server and say “use my [bench name]” in Claude Code, Cursor, VS Code, or Windsurf.
a-gnt's Take
Our honest review
Autonomous AI development loop for Claude Code with intelligent exit detection. Best for anyone looking to make their AI assistant more capable in automation. It's completely free and works across most major AI apps. This one just landed in the catalog — worth trying while it's fresh.
Tips for getting started
Tap "Get" above, pick your AI app, and follow the steps. Most installs take under 30 seconds.
What's New
Imported from GitHub
Ratings & Reviews
0.0
out of 5
0 ratings
No reviews yet. Be the first to share your experience.