SkillsLLM
Back to catalog

ralph-claude-code

by frankbria

Pending

Autonomous AI development loop for Claude Code with intelligent exit detection

6,168stars
428forks
Shell
Added 12/31/2025
View on GitHubDownload ZIP
AI Agentsaiai-agentai-agentsai-developmentai-development-toolsclaude-codeclaude-code-clidevelopment-toolsdevelopment-workflow
Installation
# Add to your Claude Code skills
git clone https://github.com/frankbria/ralph-claude-code
README.md

Ralph for Claude Code

CI License: MIT Version Tests GitHub Issues Mentioned in Awesome Claude Code Follow on X

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.4 - Active Development Core Features: Working and tested Test Coverage: 465 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.4 - Bug Fixes & Compatibility (latest)

  • Fixed progress detection: Git commits within a loop now count as progress (#141)
  • Fixed checkbox regex: Date entries [2026-01-29] no longer counted as checkboxes (#144)
  • Fixed session hijacking: Use --resume <session_id> instead of `--conti...