ralph-loop

Manage Ralph orchestration loops, monitor statuses, merge completed work, troubleshoot failures via CLI commands.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Happyverse-Team/video-content-generator --skill ralph-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-loop
Source: https://github.com/Happyverse-Team/video-content-generator/tree/main/.claude/skills/ralph-loop
Command: npx skills add https://github.com/Happyverse-Team/video-content-generator --skill ralph-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams manage Ralph orchestration loops by providing a unified set of commands to start, monitor, resume, and cancel parallel loops, reducing manual tracking and errors.

Core Features & Use Cases

  • Monitor active loops across workspaces and environments.
  • View loop diffs and logs to diagnose progress and failures.
  • Control loop lifecycles with commands to start, stop, merge, retry, or discard.

Quick Start

Use the Ralph CLI to view current loops, inspect status, and manage merges: ralph loops ralph loops diff <id> ralph loops logs <id> -f ralph loops merge <id> ralph loops stop <id>

Frequently Asked Questions about ralph-loop

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

FAQPage Schema
How do I monitor orchestration loops across multiple workspaces?

To monitor orchestration loops across multiple workspaces, use the `ralph loops` command to list active loops and inspect their status. This provides a unified view of all running processes, reducing manual tracking errors.

What is the best way to troubleshoot a failed Ralph orchestration loop?

The best way to troubleshoot a failed Ralph orchestration loop is by viewing loop diffs and logs. Use `ralph loops diff <id>` and `ralph loops logs <id> -f` to diagnose progress issues and identify failure points.

Can I resume or retry a canceled orchestration loop?

Yes, you can control the orchestration loop lifecycle by using commands to start, stop, merge, retry, or discard. This allows you to safely resume or retry interrupted loops without losing completed work.

How do I merge completed work from a parallel loop?

To merge completed work from a parallel loop, use the `ralph loops merge <id>` command. This integrates the finished changes from the specified loop into your project while exposing the current loop state in the .ralph directory.

Does Ralph support attaching to worktrees during loop orchestration?

Yes, Ralph supports attaching to worktrees during loop orchestration. You can attach to worktrees to directly inspect and interact with the ongoing changes made by active loops across single or multi-workspace projects.