ralph-commands

Control Ralph Wiggum autonomous loops with manual intervention commands.

Updated Sep 28, 2025
One-click install
npx skills add https://github.com/jbhicks/sound-cistern --skill ralph-commands
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-commands
Source: https://github.com/jbhicks/sound-cistern/tree/main/skill/ralph-commands
Command: npx skills add https://github.com/jbhicks/sound-cistern --skill ralph-commands

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides user intervention commands to manage Ralph Wiggum autonomous loops during execution, enabling manual control, pausing, resuming, status checks, hints, and budget adjustments to ensure safe and predictable loop progress.

Core Features & Use Cases

  • /ralph-status: Display current loop status, progress, and budget information.
  • /ralph-pause: Temporarily halt the autonomous loop for user intervention.
  • /ralph-resume: Resume the loop from pause and continue execution.
  • /ralph-hint "message": Add targeted guidance for the next iteration of a task.
  • /ralph-cost-limit [amount]: Update total budget allocation for the loop.
  • /ralph-task-status [task_name]: Retrieve detailed status for a specific task.
  • /ralph-complete [task_name]: Manually mark a task as complete, bypassing verification.
  • /ralph-reset [task_name]: Reset a task to pending, clearing iteration history.
  • /ralph-rollback [checkpoint]: Roll back the loop state to a git checkpoint.
  • Integration with Ralph Orchestrator: Commands coordinate with the orchestrator to update shared state, enforce behavior changes, and provide user feedback.

Quick Start

Run the Ralph orchestrator and begin issuing commands such as /ralph-status to inspect progress, /ralph-pause to intervene, and /ralph-resume to continue. For targeted task adjustments, use /ralph-task-status and /ralph-hint as needed.

Frequently Asked Questions about ralph-commands

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

FAQPage Schema
How do I pause an autonomous loop during execution to make manual adjustments?

To pause an autonomous loop during execution, issue the /ralph-pause command to temporarily halt progress for user intervention, apply manual adjustments, and then use /ralph-resume to continue execution.

How do I check the progress and budget status of a running autonomous loop?

You can check loop progress and budget status by issuing the /ralph-status command, which displays current autonomous loop progress, task status, and total budget allocation information.

Can I manually mark a task as complete and bypass verification in an orchestrator?

Yes, you can manually mark a task as complete and bypass verification by issuing the /ralph-complete [task_name] command, which updates the shared state within the Ralph Orchestrator to reflect the completion.

What is the best way to provide targeted guidance for the next iteration of a task?

The best way to provide targeted guidance for the next iteration is to use the /ralph-hint "message" command, which adds specific instructions to steer the autonomous loop during its upcoming processing cycle.

How do I roll back the loop state to a previous checkpoint?

To roll back the loop state to a previous checkpoint, issue the /ralph-rollback [checkpoint] command, which restores the autonomous loop state using a specified git checkpoint to revert progress.

Does this command control tool require any specific dependencies to manage loops?

No, this command control tool for managing autonomous loops has no external dependencies, allowing direct integration with the Ralph Orchestrator for state updates and audit logging without additional environment setup.