mission-ralph

Launch the Ralph loop for a feature ID in background execution modes.

3|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/thebrownproject/space-agents --skill mission-ralph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mission-ralph
Source: https://github.com/thebrownproject/space-agents/tree/main/skills/mission-ralph
Command: npx skills add https://github.com/thebrownproject/space-agents --skill mission-ralph

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bd, claude, mprocs, and includes scripts (resource) components.

What problem does it solve?

Orchestrates end-to-end background execution of feature work by launching the Ralph loop against a feature ID in Beads-enabled projects.

Core Features & Use Cases

  • Lightweight default mode runs the loop in the background to process tasks quickly.
  • Pod mode enables a full Pathfinder/Builder/Inspector crew for complex tasks.
  • Visible mode via ralph-visible.sh or mprocs provides real-time monitoring and control.
  • Automatic progress tracking and blocking bug creation help maintain feature flow and quality.

Quick Start

Launch the Ralph loop for a given feature ID in the background and monitor progress with /capcom.

Frequently Asked Questions about mission-ralph

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

FAQPage Schema
How do I run background task orchestration for large features in Claude?

Background task orchestration for large features runs by launching the Ralph loop against a specific feature ID, processing multiple tasks automatically while you monitor progress via status updates and completion signaling.

What is the difference between lightweight and Pod mode for task execution?

Lightweight mode processes background tasks quickly using minimal resources, while Pod mode enables a full Pathfinder, Builder, and Inspector crew to handle complex feature tasks requiring deeper orchestration and quality control.

How do I monitor real-time progress of background feature execution?

Real-time monitoring of background execution is available using the visible mode script or mprocs, which provide live tracking and control over the Ralph loop as it processes tasks against your feature ID.

Does background feature execution require Beads integration to work?

Beads integration is required because the orchestration launches the Ralph loop against a feature ID specifically within Beads-enabled projects, relying on it for task lifecycle management and progress tracking.

How are blocking bugs handled during automated task processing?

Automated task processing handles blocking bugs by creating them automatically when encountered, helping maintain feature flow and quality while the background loop continues orchestrating remaining tasks.

Do I need mprocs installed to monitor background task orchestration?

Mprocs is required for visible mode monitoring and control of the background execution, though the default lightweight mode can run background processing without it using standard start and status update mechanisms.