Skip to main content
ClaudeWave
EN, English
frankbria / Subagents

ralph-claude-code

Autonomous AI development loop for Claude Code with intelligent exit detection

  • 9.7k stars
  • 730 forks
  • 18 open issues
  • Language: Shell
  • License: MIT
  • updated
Install in ClaudeView on GitHub

Install

Terminal
git clone https://github.com/frankbria/ralph-claude-code && cp ralph-claude-code/*.md ~/.claude/agents/
  1. Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
  2. Start a new Claude Code session to load the agents.
  3. Delegate work to them with the Task/Agent tool or by name.

Editor's note

Ralph for Claude Code is a Shell-based automation layer that wraps the Claude Code CLI in a self-sustaining development loop, implementing Geoffrey Huntley's "Ralph" technique. It repeatedly invokes Claude Code against a project until a dual-condition exit gate is satisfied: both semantic completion indicators and an explicit EXIT_SIGNAL must be present before the loop terminates. Built-in safeguards include a configurable rate limiter capped at 100 API calls per hour, a circuit breaker that halts runaway loops on detected errors, and a session continuity flag (--resume) that preserves context across runs. Companion commands cover the full workflow: ralph-enable runs a five-phase interactive wizard that auto-detects project type and framework, ralph-import pulls tasks from PRDs or GitHub issues with metadata filters, ralph-stats outputs per-loop metrics in JSON Lines format, and --backup automatically creates git branches with --rollback restore. Desktop notifications, tmux monitoring, dry-run simulation, and live streaming output round out the toolset. Developers running unattended Claude Code sessions on real codebases benefit most.

README

Subagents overview

README preview not available. Visit the repo on GitHub for full documentation.
Use cases
Automation
Topics
aiai-agentai-agentsai-developmentai-development-toolsclaude-codeclaude-code-clidevelopment-toolsdevelopment-workflow
Frequently asked

What people ask about ralph-claude-code

What is frankbria/ralph-claude-code?

frankbria/ralph-claude-code is subagents for the Claude AI ecosystem. Autonomous AI development loop for Claude Code with intelligent exit detection It has 9.7k GitHub stars and its last recorded update is dated 2026-10-17.

How do I install ralph-claude-code?

You can install ralph-claude-code by cloning the repository (https://github.com/frankbria/ralph-claude-code) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.

Is frankbria/ralph-claude-code safe to use?

Our security agent has analyzed frankbria/ralph-claude-code and assigned a Trust Score of 100/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.

Who maintains frankbria/ralph-claude-code?

frankbria/ralph-claude-code is maintained by frankbria. The last recorded GitHub activity is dated 2026-10-17, with 18 open issues.

Are there alternatives to ralph-claude-code?

Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.