ralph-status

Display Ralph build status and progress. Use when user asks for "ralph status", "build status", "queue status", or wants to see subtask progress and iteration statistics.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/ralph-status

SKILL.md

Ralph Status

Display the current Ralph build status, including subtask progress, iteration statistics, and configuration state.

Usage

/ralph-status [subtasks-path]

Arguments

Argument	Description
`subtasks-path`	Optional path to subtasks.json file (defaults to `subtasks.json` in project root)

What It Shows

Configuration

Whether ralph.config.json exists in the project

Subtasks Queue

Current milestone name (from taskRef or milestone field)
Progress bar with done/total count and percentage
Last completed subtask with timestamp
Next pending subtask in queue

Iteration Statistics

Total iteration count from diary
Success rate (color-coded: green ≥80%, yellow ≥50%, red <50%)
Average tool calls per iteration

Examples

Check current build status:

/ralph-status

Check status for a specific subtasks file:

/ralph-status docs/planning/milestones/ralph/subtasks.json

Execution

When invoked, execute the status script:

bash

tools/src/commands/ralph/scripts/status.sh [subtasks-path]

The script handles:

Missing subtasks file (shows helpful guidance)
Empty subtask queue (shows empty state message)
Missing iteration diary (gracefully degrades)
Both jq and Node.js fallbacks for JSON parsing

CLI Equivalent

This skill provides the same functionality as: