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.
📖 Read the full source: r/ClaudeAI
👀 See Also
Self-Hosted Contextual Bandit in Rust: Syntra & Lycan for Adaptive Decision Systems
Two open-source projects: Lycan (graph execution language with strategy nodes and learned weights) and Syntra (Docker/API appliance serving compiled Lycan capsules). Found data pipeline bugs before runtime bugs when dogfooding on an AI stock-debate product.
read-once: A Claude Code Hook That Prevents Redundant File Reads
A developer built a PreToolUse hook called read-once that tracks files Claude Code has already read in a session, blocking re-reads of unchanged files and using diffs for changed files. The tool saves thousands of tokens per session by preventing Claude from repeatedly reading the same file content.
BrowserKing: Open-Source Chrome Extension for Browser Control via Claude and Other Models
BrowserKing is a free, open-source Chrome extension that lets Claude and 15+ other models see and control your browser from a side panel. It takes screenshots, sends them to the model, and then acts on decisions to click buttons, fill forms, scroll, and navigate tabs.
Ephemeral OpenClaw setups with network sandboxing and auto-teardown
A setup that boots OpenClaw inside an ephemeral VM with a network egress allowlist, injects API keys into RAM-backed storage, and includes a 2-hour auto-teardown. All LLM calls are recorded to SQLite for replay.