ralph

Manage iterative loops with pacing control and progress tracking in Codex tasks.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/san-tian/codex-ralph-loop-tools --skill ralph-san-tian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/san-tian/codex-ralph-loop-tools/tree/main/skills/ralph
Command: npx skills add https://github.com/san-tian/codex-ralph-loop-tools --skill ralph-san-tian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, tmux, Codex CLI, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured approach to managing iterative loops in complex tasks, enabling pacing control and verifiable progress tracking.

Core Features & Use Cases

  • Loop Management: Start, stop, resume, and manage iterative loops for tasks with multiple steps or periods of reflection.
  • Progress Tracking: Record verification evidence and track progress through loop iterations.
  • Use Case: For instance, use this Skill to manage a software development project that involves regular testing, debugging, and verification.

Quick Start

Use the ralph skill to start a loop for a software development project by calling 'ralph_start name: "Project A" taskContent: "Develop a new feature." maxIterations: 10 reflectEvery: 5 reflectInstructions: "Review code and documentation every 5 iterations."'

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I manage iterative loops for complex software development tasks?

Iterative loop management for complex software development tasks is handled through structured operations like start, continue, pause, resume, and cancel. This approach enforces pacing control and tracks verifiable progress across multiple task iterations within Codex.

What is the best way to track verifiable progress in Codex task loops?

Tracking verifiable progress in Codex task loops involves recording verification evidence during each iteration. The loop management framework supports status checks and archiving to maintain a clear history of task completion and reflection periods.

Do I need a Codex plugin to run iterative task management loops?

Yes, running iterative task management loops requires Codex plugin loading and workspace hook support. The environment also depends on Python3 and tmux to execute the underlying scripts and manage the structured loop framework.

Can I pause and resume software development loops without losing task progress?

Pausing and resuming software development loops preserves task progress through the framework's structured state management. You can use pause and resume operations to control pacing, with status checks ensuring verifiable progress is maintained across iterations.

How do I start an iterative loop with pacing control for a coding project?

Starting an iterative loop with pacing control involves calling the start operation with parameters like task content, maximum iterations, and reflection intervals. This configures a structured framework for regular code review and verification throughout the development cycle.

When should I not use iterative loop management for task execution?

Iterative loop management should not be used for single-step tasks or environments lacking Codex CLI, Python3, and tmux dependencies. It is designed for multi-step workflows requiring pacing control, regular reflection, and verifiable progress tracking.