umputun/ralphex

What is it?

Key features

• 01Runs each plan task in a fresh Claude Code or codex session with validation after every task.
• 02Runs a multi-phase review pipeline with parallel review agents and an optional external reviewer.
• 03Creates a git branch from the plan filename and commits after each task and review fix.
• 04Supports git worktrees for executing several plans in parallel on one repository.
• 05Provides a real-time web dashboard via the --serve flag.
• 06Can run in a Docker container to limit what the autonomous agent can access.

Use cases

• Implementing a multi-task feature from a written plan while away from the terminal.
• Running an automated code review on changes made outside ralphex by other tools or by hand.
• Running several independent plans at once in separate worktrees.
• Using codex as the sole executor when a Claude subscription is not an option.

Quick start

1. 1

   Install ralphex with Go

2. 2

   Create a plan file in docs/plans/

3. 3

   Run ralphex on the plan file

   ralphex docs/plans/my-feature.md

Things to know

• !Requires a Claude Code or codex coding agent to be set up separately.
• !Default Claude mode uses claude --print, which falls under Anthropic's new Agent SDK credit billing from June 15, 2026.

In collections

Topics

FAQ

What is ralphex?

A standalone Go CLI that runs Claude Code or codex autonomously through a markdown implementation plan, with per-task fresh sessions and multi-phase code review. ralphex is a command-line tool that runs from the root of a git repository and orchestrates Claude Code or the codex CLI to execute an implementation plan without supervision. A plan is a markdown file with tasks and validation commands. Each task runs in a fresh coding-agent session, which keeps context small as the plan progresses. Validation commands run after each task, checkboxes are ticked, and changes are committed.

Is ralphex free to use? What license does it have?

ralphex is open source under the MIT license. Check the license terms before using it in commercial products.

Is ralphex still maintained?

Actively maintained. The last commit to ralphex was on Nov 2, 2026.

What can I use ralphex for?

Implementing a multi-task feature from a written plan while away from the terminal. Running an automated code review on changes made outside ralphex by other tools or by hand. Running several independent plans at once in separate worktrees. Using codex as the sole executor when a Claude subscription is not an option.

How do I install ralphex?

Install ralphex with Go Create a plan file in docs/plans/ Run ralphex on the plan file: ralphex docs/plans/my-feature.md

Where can I get ralphex?

The source code and installation instructions are on GitHub: https://github.com/umputun/ralphex