umputun/ralphex

O que é?

Recursos principais

• 01Executa cada tarefa do plano em uma sessão nova do Claude Code ou codex, com validação após cada tarefa.
• 02Executa um fluxo de revisão em várias fases, com agentes de revisão em paralelo e um revisor externo opcional.
• 03Cria uma branch Git com base no nome do arquivo do plano e faz commit após cada tarefa e correção da revisão.
• 04Oferece suporte a git worktrees para executar vários planos em paralelo em um único repositório.
• 05Oferece um painel web em tempo real por meio da flag --serve.
• 06Pode rodar em um contêiner Docker para limitar o que o agente autônomo pode acessar.

Casos de uso

• Implementar uma funcionalidade com várias tarefas a partir de um plano escrito enquanto você está longe do terminal.
• Fazer uma revisão de código automatizada de alterações feitas fora do ralphex, por outras ferramentas ou manualmente.
• Executar vários planos independentes ao mesmo tempo, em worktrees separados.
• Usar o codex como único executor quando uma assinatura do Claude não for uma opção.

Início rápido

1. 1

   Instale o ralphex com Go

2. 2

   Crie um arquivo de plano em docs/plans/

3. 3

   Execute o ralphex no arquivo de plano

   ralphex docs/plans/my-feature.md

Antes de usar

• !É necessário configurar separadamente um agente de programação Claude Code ou codex.
• !O modo padrão do Claude usa claude --print, sujeito à nova cobrança por créditos do Agent SDK da Anthropic a partir de 15 de junho de 2026.

Em coleções

Tópicos

Perguntas frequentes

O que é ralphex?

Uma CLI standalone em Go que executa Claude Code ou codex de forma autônoma a partir de um plano de implementação em Markdown, com sessões novas por tarefa e revisão de código em várias fases. ralphex é uma ferramenta de linha de comando que roda na raiz de um repositório Git e coordena o Claude Code ou a CLI do codex para executar um plano de implementação sem supervisão. O plano é um arquivo Markdown com tarefas e comandos de validação. Cada tarefa roda em uma sessão nova do agente de programação, mantendo o contexto enxuto à medida que o plano avança. Os comandos de validação são executados após cada tarefa, as caixas são marcadas e as alterações são commitadas.

ralphex é gratuito? Qual é a licença?

ralphex é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

ralphex ainda é mantido?

Manutenção ativa. O último commit de ralphex foi em 2 de nov. de 2026.

Para que posso usar ralphex?

Implementar uma funcionalidade com várias tarefas a partir de um plano escrito enquanto você está longe do terminal. Fazer uma revisão de código automatizada de alterações feitas fora do ralphex, por outras ferramentas ou manualmente. Executar vários planos independentes ao mesmo tempo, em worktrees separados. Usar o codex como único executor quando uma assinatura do Claude não for uma opção.

Como instalar ralphex?

Instale o ralphex com Go Crie um arquivo de plano em docs/plans/ Execute o ralphex no arquivo de plano: ralphex docs/plans/my-feature.md

Onde consigo ralphex?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/umputun/ralphex