RalphTerm: ralph-style loop for Claude Code with cross-review sessions from different agents

RalphTerm is an open-source CLI (MIT, Rust) that implements a ralph-style coding loop around Claude Code. It does not replace Claude Code — it is an outer loop that drives fresh interactive Claude Code sessions via a PTY, unlike ralphex which uses non-interactive -p/--print mode.

How it works

• Take a markdown plan with checkbox tasks.
• Start a fresh Claude Code session for the next unfinished task.
• Let Claude edit files, run validation, commit, and mark the task done.
• Repeat until the plan is complete.
• Then start independent reviewer sessions, usually with a different agent such as Codex.
• If the reviewer finds a real issue, send that feedback back into a fresh implementer session.
• Keep iterating until the plan is done and the cross-review is clean.

Key differences from ralphex and /codex

RalphTerm drives the real interactive Claude Code terminal through a PTY. This matters because, starting June 15, 2026, Anthropic's Agent SDK and claude -p usage draw from a separate monthly credit distinct from interactive usage limits. RalphTerm stays inside interactive session limits.

It also leans harder into cross-review: Claude implements, Codex reviews the branch in a separate fresh session using git diff and transcript as inputs. If Codex finds an issue, RalphTerm feeds it into a new implementer session, runs validation again, and repeats the review gate. This differs from Claude Code's built-in /codex integration, which runs inside the same interactive session.

Usage

sh
ralphterm docs/plans/feature.md

Installation

sh
brew tap RayforceDB/ralphterm https://github.com/RayforceDB/ralphterm
brew install ralphterm

or:

sh
curl -sSf https://ralphterm.rayforcedb.com/install.sh | sh

or:

sh
cargo install ralphterm

Project links

• Repo: https://github.com/RayforceDB/ralphterm
• Website/docs: https://ralphterm.rayforcedb.com/

Who it's for

Developers using Claude Code for longer unattended runs who want a more reliable loop with cross-model validation.