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
Local MCP Memory System with Consolidation for AI Conversations
A developer built an MCP server that provides persistent local memory for AI clients, using Qwen 2.5-7B to consolidate conversations into structured knowledge documents every 6 hours. The system runs entirely on your hardware with semantic dedup, adaptive scoring, and FAISS vector search.
How Claude Helped Reverse-Engineer Garmin’s BLE Protocols to Fake a Native Running Sensor
A developer used Claude to reverse-engineer Garmin’s undocumented BLE protocols, making an ESP32 look like a native HRM strap — dual identity switching and running dynamics RE.
McPherson AI releases two new QSR operations skills on ClawHub: food cost diagnostics and labor leak auditing
Two new free skills have been published on ClawHub: qsr-food-cost-diagnostic catches COGS issues weekly with a four-lever diagnostic, and qsr-labor-leak-auditor provides daily labor tracking with mid-week alerts to prevent overspend.
Claude Code: How to Connect Your AI-Built Frontend to a Real Backend
Claude Code builds polished frontends but often uses hardcoded data. Here are four ways to connect it to real backends: raw APIs, SDKs, CLIs, and MCP.