ralph-wiggum

Manage iterative development loops in Codex with pacing and progress tracking.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Manages long-running iterative development loops with pacing control and verifiable progress, ideal for tasks requiring multiple iterations and discrete steps.

Core Features & Use Cases

  • Iterative Loop Management: Start, resume, stop, and archive iterative development loops.
  • Pacing Control: Adjust loop timing and reflection checkpoints.
  • Verifiable Progress: Ensure loop progress is accurately recorded and confirmed.
  • Use Case: When planning a complex project with multiple steps, use Ralph Wiggum to manage iterations, track progress, and ensure all tasks are completed.

Quick Start

To start a new loop for a project, use the command: 'ralph_start project_name'

Frequently Asked Questions about ralph-wiggum

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

FAQPage Schema
How do I manage iterative development loops with pacing control in Codex?

Iterative development loops with pacing control are managed in Codex by executing discrete control operations like start, done, status, resume, stop, list, cancel, and archive. This approach ensures verifiable progress across multiple iterations.

What is verifiable progress tracking for long-running development iterations?

Verifiable progress tracking records and confirms each discrete step within long-running iterations. It ensures that loop progress is accurately captured during pacing checkpoints before proceeding to the next development phase.

How do I start and resume an iterative development loop for a project?

Starting an iterative development loop requires executing the 'ralph_start project_name' command. You can resume paused loops using the resume operation to continue tracking discrete steps from the last verifiable progress checkpoint.

Do I need Codex CLI with plugin loading to run iterative loop management?

Codex CLI with plugin loading and workspace hook support is required for iterative loop management. These dependencies allow the system to handle pacing control and execute discrete step operations within the development environment.

When should I use pacing control for iterative development loops?

Pacing control for iterative development loops should be used when planning complex projects requiring multiple iterations. It adjusts loop timing and establishes reflection checkpoints to ensure tasks are completed with verifiable progress.