ralph-claude-code

Autonomous AI development loop for Claude Code with intelligent exit detection

What is ralph-claude-code?

Autonomous AI development loop for Claude Code with intelligent exit detection

Overview of ralph-claude-code

What it is

Ralph for Claude Code is an autonomous AI development loop tool that implements Geoffrey Huntley's technique for Claude Code. It enables continuous autonomous development cycles where Claude Code iteratively improves a project until completion, with built-in safeguards to prevent infinite loops and API overuse. The tool is installed as a global command available in any directory. Version v0.11.5 is in active development with 784 tests and a 100% pass rate.

Key features

  • Autonomous development loop with intelligent exit detection using a dual-condition exit gate (requires both completion indicators and explicit EXIT_SIGNAL)
  • Rate limiting with hourly reset (100 calls/hour, configurable) and circuit breaker with advanced error detection
  • 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 and session expiration with configurable timeout (default 24 hours)
  • Interactive project enablement wizard (ralph-enable) and .ralphrc configuration file for project settings
  • Live streaming output (--live), dry-run mode (--dry-run), metrics tracking (ralph-stats), desktop notifications (--notify), and automatic git backup branches (--backup with --rollback)
  • GitHub issue import with metadata filters, PRD import, tmux integration, and CI/CD pipeline with GitHub Actions

Use cases

  • Autonomous iterative development where Claude Code refines a project based on requirements until completion
  • Continuous integration and deployment pipelines that require automated code generation and improvement
  • Projects needing safeguards against infinite loops and API overuse during AI-assisted development
  • Teams that want to integrate Claude Code into automated workflows with session management and monitoring

Getting started

See the repository README for installation instructions.

License and pricing

This project is licensed under MIT and is open source (free).

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/frankbriaralph-claude-code.svg)](https://yunodb.com/tools/frankbriaralph-claude-code?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/frankbriaralph-claude-code?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/frankbriaralph-claude-code.svg" alt="Featured on YunoDB" height="20"></a>