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:

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:

aaa ralph status [subtasks-path]

Related Skills

• ralph-build: Run the build loop to process subtasks
• ralph-calibrate: Run calibration checks on completed work
• ralph-plan: Interactive planning for vision and roadmap