// devtools · frankbria/ralph-claude-code

ralph-claude-code

ralph-claude-code é um projeto de ferramentas de desenvolvimento de código aberto de frankbria (frankbria/ralph-claude-code no GitHub). Tem 9.671 estrelas no GitHub e 726 forks, é publicado sob a licença MIT e foi atualizado pela última vez no GitHub em 8 de outubro de 2026.

An autonomous loop for Claude Code with intelligent exit detection, rate limits and a circuit breaker.

★ 9,7 mil estrelas⑂ 726 forksMITatualizado out 2026
▦ visual: o README deste projeto não inclui nenhuma captura incorporável,
então aqui vai um marcador. O guia abaixo está completo mesmo assim.
// dados do projeto

Dados do projeto

Estrelas no GitHub
9.671
Forks
726
Licença
MIT
Última atualização no GitHub
8 de outubro de 2026
Tipo de ficha
Guia de instalação completo
// como funciona

Como funciona

  1. Clarify your goal

    Define the project and task list Ralph should work through, and set sensible call limits in the project config before letting it run unattended.

  2. Get the project

    Clone frankbria/ralph-claude-code from GitHub (or use the install path in the run steps below) and skim its README for the parts relevant to your goal.

  3. Install and configure

    Clone the repo, run its install script, and make sure the Claude Code CLI and GitHub CLI are installed; then enable Ralph in a project with the setup wizard.

  4. Run your first task

    Start the loop in a project, watch live output with the live flag, and let the exit gate and circuit breaker decide when it is done or stuck.

// recursos

Por que as pessoas gostam tanto

Dual-condition exit gate

Exit requires BOTH completion indicators AND an explicit EXIT_SIGNAL, so the loop neither quits early nor claims success falsely.

Rate limiting

An hourly limiter (100 calls/hour by default, configurable) with hourly reset keeps unattended runs inside a budget.

Circuit breaker

Advanced error detection trips a circuit breaker to prevent runaway loops when the agent is stuck repeating failures.

Response analyzer

Semantic response analysis with two-stage error filtering, plus JSON output format support with automatic fallback to text parsing.

Session continuity

A --resume flag preserves context across runs with configurable session expiration (24 hours by default), without session hijacking.

Operator tooling

Live streaming output, dry-run mode, desktop notifications, log rotation, ralph-stats metrics, and automatic git backup branches with rollback.

Advertisement
// execute você mesmo

Execute você mesmo

  1. Clone the repository

    Get the source from the official GitHub repository for ralph-claude-code.

    git clone https://github.com/frankbria/ralph-claude-code.git
    cd ralph-claude-code
  2. Install Ralph

    Run the project's own installer after cloning, as the README documents.

    ./install.sh
  3. Enable and run in a project

    Use the enable wizard to set up a project, then start the autonomous loop.

    ralph-setup my-project  # via the ralph-enable wizard
    ralph --live  # see README for the exact loop command in your setup
// casos de uso

O que você pode criar

Advertisement
// perguntas frequentes

Perguntas frequentes

Who maintains ralph-claude-code?

frankbria, through the frankbria/ralph-claude-code repository.

Is ralph-claude-code free to use?

Yes — the project is open source under the MIT license as recorded for this listing. You can use, modify and distribute it under the MIT terms.

Does ralph-claude-code need a paid API key?

Yes — it drives the Claude Code CLI, so you need Claude Code set up with your own Anthropic access; Ralph itself is free and open source.

How does Ralph compare to just running Claude Code interactively?

Interactive Claude Code stops whenever you stop prompting. Ralph wraps it in a managed loop — exit detection, rate limiting, a circuit breaker, metrics and git backups — designed for unattended runs, at the cost of needing careful task setup.

How do I get started with ralph-claude-code?

Clone the repository (or use the documented installer), follow the install and configure steps on this page, and run the smallest real task first — start the loop in a project, watch live output with the live flag, and let the exit gate and circuit breaker decide when it is done or stuck.

// continue explorando

Ferramentas semelhantes

Ferramentas de desenvolvimento

claudex-loop

Claude Code skill: four-phase plan hardening (recon, interrogate, Codex adversarial review, cross-model build & inspection) — two AI models harden your plan …

★ 2,7 mil estrelasUnknown
Ver o guia →
Ferramentas de desenvolvimento

flounder

Autonomous white-hat auditor — AI code review, bug-bounty research, exploit checks.

★ 516 estrelasAGPL-3.0
Ver o guia →
Ferramentas de desenvolvimento

Mobile-Harness

Claude Code on Android — an AI mobile coding IDE with Linux commands.

★ 506 estrelasMIT
Ver o guia →
Ferramentas de desenvolvimento

repowise

Repowise — codebase intelligence: health scores, auto-docs, git analytics and dead-code detection via MCP.

★ 7,2 mil estrelasAGPL-3.0
Ver o guia →
Ferramentas de desenvolvimento

clawgod

Runtime patch for Claude Code, kept compatible with every version update.

★ 2,1 mil estrelasGPL-3.0
Ver o guia →
Ferramentas de desenvolvimento

jarvis

A voice assistant for Claude Code — brainstorm, build and hear it report back.

★ 824 estrelasCustom
Ver o guia →
// alternativas

Alternativas em Ferramentas de desenvolvimento

Os outros projetos de Ferramentas de desenvolvimento com mais estrelas no catálogo do LibreAI — a lista realista de alternativas se ralph-claude-code não for o ideal para você.

// mais em devtools

Mais em Ferramentas de desenvolvimento

Projetos de Ferramentas de desenvolvimento próximos no catálogo, os mais próximos em estrelas de ralph-claude-code: continue explorando dos dois lados dele.

Baixe o ralph-claude-code

Grátis e aberto: pegue o código-fonte, dê uma estrela no repositório e comece a criar.