frankbria

Ralph For Claude Code — AI skill for Claude Code

AI community intermediate

by Frank Bria - An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion.

How to install Ralph For Claude Code

This entry records only its repository, not the path inside it, so there is no exact command to give. Open frankbria/ralph-claude-code and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Ralph For Claude Code does

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

Alternatives in AI

Peekaboo — Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, o 3.2k ★
Ralphex — Extended Ralph loop for autonomous AI-driven plan execution 1.1k ★
Zotero MCP — It's a plugin extension in Zotero 1.1k ★

README

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