Skip to main content

moai loop Feedback Loop

UPDATED 2026-07-15 1 min read EDIT ON GITHUB ↗

moai loop manages the SPEC-lifecycle Ralph feedback-loop controller. It drives a state machine that iterates over the work detected by tool diagnostics for a single SPEC.

This CLI command is distinct from the /moai loop skill in the Claude Code chat — the CLI manipulates the loop-controller state, while the /moai loop skill has the orchestrator perform the actual iterative fixes.

Subcommands

CommandDescription
moai loop start <SPEC-ID>Start a feedback loop for a SPEC
moai loop statusShow the current loop status
moai loop pausePause a running loop
moai loop resume <SPEC-ID>Resume a paused loop
moai loop cancelCancel a running loop

Examples

bash
# Start a loop for a SPEC
moai loop start SPEC-AUTH-001

# Check the current status
moai loop status

# Pause and resume later
moai loop pause
moai loop resume SPEC-AUTH-001

# Cancel the loop
moai loop cancel