Repolode
umputun

umputun/ralphex

CLI independiente en Go que ejecuta Claude Code o codex de forma autónoma a partir de un plan de implementación en Markdown, con sesiones nuevas por tarea y revisión de código en varias fases.

Estrellas
1,510
Forks
134
Issues abiertos
4
Último commit
hace 4 días

¿Qué es?

ralphex es una herramienta de línea de comandos que se ejecuta desde la raíz de un repositorio git y coordina Claude Code o la CLI de codex para llevar a cabo un plan de implementación sin supervisión. El plan es un archivo Markdown con tareas y comandos de validación. Cada tarea se ejecuta en una sesión nueva del agente de programación, lo que mantiene acotado el contexto a medida que avanza el plan. Después de cada tarea se ejecutan los comandos de validación, se marcan las casillas y se confirman los cambios.

Al terminar las tareas, ralphex ejecuta un flujo de revisión: varios agentes revisan en paralelo, se puede usar una herramienta de revisión externa como codex y se realiza una segunda revisión más acotada. Crea una rama de funcionalidad a partir del nombre del archivo del plan, mueve los planes completados a una carpeta específica y puede ejecutarse en un git worktree para procesar varios planes en paralelo. También ofrece un panel web, aislamiento con Docker y notificaciones mediante Telegram, Email, Slack, webhooks o un script personalizado.

El proyecto no requiere plugins de IDE ni servicios en la nube. Se distribuye como un único binario a través de Go, Homebrew o descargas de las versiones publicadas.

Funciones clave

  • 01Ejecuta cada tarea del plan en una sesión nueva de Claude Code o codex y valida el resultado después de cada tarea.
  • 02Ejecuta un flujo de revisión en varias fases, con agentes que revisan en paralelo y un revisor externo opcional.
  • 03Crea una rama git a partir del nombre del archivo del plan y confirma los cambios después de cada tarea y corrección de la revisión.
  • 04Admite git worktrees para ejecutar varios planes en paralelo en un mismo repositorio.
  • 05Ofrece un panel web en tiempo real mediante la opción --serve.
  • 06Puede ejecutarse en un contenedor Docker para limitar el acceso del agente autónomo.

Casos de uso

  • Implementar una funcionalidad con varias tareas a partir de un plan escrito, sin estar frente a la terminal.
  • Revisar automáticamente código modificado fuera de ralphex, ya sea con otras herramientas o manualmente.
  • Ejecutar varios planes independientes a la vez en worktrees separados.
  • Usar codex como único ejecutor cuando no se puede optar por una suscripción a Claude.

Inicio rápido

  1. 1

    Instala ralphex con Go

  2. 2

    Crea un archivo de plan en docs/plans/

  3. 3

    Ejecuta ralphex en el archivo de plan

    ralphex docs/plans/my-feature.md

Antes de usarlo

  • Es necesario configurar por separado un agente de programación Claude Code o codex.
  • El modo predeterminado de Claude usa claude --print, sujeto al nuevo sistema de facturación por créditos de Anthropic para Agent SDK a partir del 15 de junio de 2026.

En colecciones

Temas

Preguntas frecuentes

¿Qué es ralphex?
CLI independiente en Go que ejecuta Claude Code o codex de forma autónoma a partir de un plan de implementación en Markdown, con sesiones nuevas por tarea y revisión de código en varias fases. ralphex es una herramienta de línea de comandos que se ejecuta desde la raíz de un repositorio git y coordina Claude Code o la CLI de codex para llevar a cabo un plan de implementación sin supervisión. El plan es un archivo Markdown con tareas y comandos de validación. Cada tarea se ejecuta en una sesión nueva del agente de programación, lo que mantiene acotado el contexto a medida que avanza el plan. Después de cada tarea se ejecutan los comandos de validación, se marcan las casillas y se confirman los cambios.
¿ralphex es gratuito? ¿Qué licencia tiene?
ralphex es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ralphex sigue mantenido?
Mantenimiento activo. El último commit de ralphex fue el 2 nov 2026.
¿Para qué puedo usar ralphex?
Implementar una funcionalidad con varias tareas a partir de un plan escrito, sin estar frente a la terminal. Revisar automáticamente código modificado fuera de ralphex, ya sea con otras herramientas o manualmente. Ejecutar varios planes independientes a la vez en worktrees separados. Usar codex como único ejecutor cuando no se puede optar por una suscripción a Claude.
¿Cómo se instala ralphex?
Instala ralphex con Go Crea un archivo de plan en docs/plans/ Ejecuta ralphex en el archivo de plan: ralphex docs/plans/my-feature.md
¿Dónde consigo ralphex?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/umputun/ralphex

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados