ralph-supervisor

Coordinate Claude supervisor and Codex executor in git-backed coding iterations.

1|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/ImBIOS/swarm-tools --skill ralph-supervisor-imbios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-supervisor
Source: https://github.com/ImBIOS/swarm-tools/tree/main/packages/opencode-swarm-plugin/claude-plugin/skills/ralph-supervisor
Command: npx skills add https://github.com/ImBIOS/swarm-tools --skill ralph-supervisor-imbios

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph Supervisor Pattern provides a structured autonomous coding loop where Claude supervises Codex to implement tasks in iterations, ensuring fresh context per cycle and git-backed persistence.

Core Features & Use Cases

  • Orchestrates a supervisor/executor pair (Claude as supervisor, Codex as executor) to break down complex coding tasks into iterative stories and validated iterations.
  • Ensures git-backed persistence of progress, learnings, and completed work, enabling reliable rollbacks and audits.
  • Coordinates across agents using semantic memory (hivemind) and messaging (swarm mail) to sustain continuity across iterations.

Quick Start

Initiate a Ralph loop with Claude as supervisor and Codex as executor to start an autonomous coding iteration with fresh context and git-backed persistence.

Frequently Asked Questions about ralph-supervisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an autonomous coding loop with Codex and fresh context?

An autonomous coding loop uses a supervisor and executor pair to break down complex tasks into iterative stories. It applies per-iteration context resets and git-backed persistence to maintain reliable progress tracking across cycles.

What is the best way to coordinate Claude and Codex for iterative software development?

Coordinating Claude and Codex involves using one as a supervisor to track stories and review performance, while the other acts as the executor. This pattern ensures validated iterations and transfers learnings across cycles using semantic memory.

How does git-backed persistence work in an AI coding loop?

Git-backed persistence in an AI coding loop commits progress, learnings, and completed work after each validated iteration. This mechanism enables reliable rollbacks, provides audit trails, and sustains continuity even when context resets between cycles.

Can I use hivemind and swarm mail to coordinate context across autonomous coding iterations?

Yes, hivemind and swarm mail coordinate agents across autonomous coding iterations by providing semantic memory and messaging. They sustain continuity by transferring learnings and tracking stories even when the executor resets its context per cycle.

When do I need validation gates and per-iteration context resets for code generation?

Validation gates and per-iteration context resets are needed for complex software development tasks requiring strict quality control. They ensure each cycle produces verified, git-backed code artifacts while preventing context degradation across long loops.