← Back to Skills Marketplace
1281
Downloads
0
Stars
2
Active Installs
2
Versions
Install in OpenClaw
/install monitored-ralph-loop
Description
Generate copy-paste bash scripts for Ralph Wiggum/AI agent loops (Codex, Claude Code, OpenCode, Goose). Use when asked for a "Ralph loop", "Ralph Wiggum loop", or an AI loop to plan/build code via PROMPT.md + AGENTS.md, SPECS, and IMPLEMENTATION_PLAN.md, including PLANNING vs BUILDING modes, backpressure, sandboxing, and completion conditions.
Usage Guidance
This skill implements an event-driven Ralph loop, but it performs actions you should review before running. Key points to check before installing/using:
- Audit scripts/ralph.sh: it writes .ralph/pending-notification.txt containing project path and a base64-encoded tail of ralph.log and then attempts to schedule delivery via the openclaw CLI — that can leak secrets from logs or your repo. Consider removing or redacting log export before allowing notifications.
- The metadata doesn't declare required CLIs (codex, claude, opencode, goose, openclaw, git). Expect the script to fail or to attempt actions with whatever local CLI config/credentials exist. Confirm and trust any CLI (especially openclaw) before use.
- The script sets default CLI flags that include dangerous options (e.g., --dangerously-skip-permissions for Claude). Remove or change these defaults and avoid auto-approve/ full-auto flags unless you understand the consequences.
- The README shows system-level operations (sudo swap creation, systemd service): only do these in a controlled environment. Prefer a disposable VM/container or an isolated test repo/branch. Do not run as root.
- Before running: search your repo and ralph.log for secrets; run the loop first in a throwaway repo; disable automatic notification delivery (or inspect the pending-notification file manually) to prevent unintended data exfil.
If you want to proceed safely, run the script in an isolated sandbox, remove/modify the parts that export logs or schedule OpenClaw cron jobs, and avoid the permissive CLI flags. If you have concerns about OpenClaw or the coding CLI, do not grant them implicit access to your primary development environment.
Capability Assessment
Purpose & Capability
The skill's name/description (Ralph loop generator) matches the included scripts and templates. However, the package metadata declares no required binaries or env vars while the runtime script expects external CLIs (codex, claude, opencode, goose), git, and openclaw to be present; that's an omission that can surprise users. Requesting none of these in metadata is not proportional but could be an oversight rather than malicious.
Instruction Scope
SKILL.md and scripts instruct the agent/user to read and write project files, create .ralph/pending-notification.txt, include a base64-encoded tail of the log in notifications, and call openclaw cron/ gateway commands. The instructions also include commands that touch system state (systemd unit example, swap creation using sudo). Writing project path and log tails into a notification file and then attempting to schedule delivery to OpenClaw can expose sensitive data (secrets in logs, repo metadata). The SKILL.md also prescribes permission-bypassing flags (e.g., --dangerously-skip-permissions, references to auto-approve flags) which expand the agent's effective scope.
Install Mechanism
There is no install spec; this is an instruction-only skill plus a shell script. That minimizes hidden install-time risk (nothing downloaded/extracted by the skill itself).
Credentials
The skill declares no required environment variables but the script uses and suggests RALPH_CLI, RALPH_FLAGS, and RALPH_TEST. More importantly, notifications include project path and a base64-encoded log tail, which may contain credentials or other secrets. The skill will attempt to call the local openclaw CLI (if present) to schedule cron events — this implicitly uses whatever OpenClaw credentials/config are present, but the skill does not declare or request them up-front. That mismatch (collecting and forwarding potentially sensitive runtime data without explicit credential/environment declarations) is concerning.
Persistence & Privilege
The skill itself is not always-enabled and does not request persistent platform privileges, but its documentation and script encourage persistent deployment patterns: systemd service examples, cron scheduling via openclaw, and auto-restart. Combined with permissive CLI flags and notification scheduling, this enables long-lived autonomous behavior that can repeatedly read/write project files and dispatch notifications. Users could accidentally make it persistent with elevated effect.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install monitored-ralph-loop - After installation, invoke the skill by name or use
/monitored-ralph-loop - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
- Notify openClaw via cron job
- Let claw decide if issue has to be surfaced to human or can be handled by itself
v0.1.0
Ralph Loop 0.1.0 introduces an event-driven bash scripting pattern for AI agent loops (Codex, Claude Code, OpenCode, Goose), emphasizing durable, file-based, and parallelizable coordination.
- New event-driven notification system replaces polling: agents notify OpenClaw or fallback to file-based `.ralph/pending-notification.txt` if unavailable.
- Each iteration starts a clean agent session; context is preserved only via files (`AGENTS.md`, `IMPLEMENTATION_PLAN.md`, etc.).
- Recovery protocol for processing pending notifications after interruptions or rate limits.
- Split operation modes: PLANNING vs BUILDING, each with clear workflow, notification, and completion rules.
- Explicit backpressure, sandboxing, and CLI-specific behaviors documented for robust automation.
- Supports parallel execution using git worktrees for independent tasks and sessions.
Metadata
Frequently Asked Questions
What is Monitored Ralph Loop?
Generate copy-paste bash scripts for Ralph Wiggum/AI agent loops (Codex, Claude Code, OpenCode, Goose). Use when asked for a "Ralph loop", "Ralph Wiggum loop", or an AI loop to plan/build code via PROMPT.md + AGENTS.md, SPECS, and IMPLEMENTATION_PLAN.md, including PLANNING vs BUILDING modes, backpressure, sandboxing, and completion conditions. It is an AI Agent Skill for Claude Code / OpenClaw, with 1281 downloads so far.
How do I install Monitored Ralph Loop?
Run "/install monitored-ralph-loop" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Monitored Ralph Loop free?
Yes, Monitored Ralph Loop is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Monitored Ralph Loop support?
Monitored Ralph Loop is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Monitored Ralph Loop?
It is built and maintained by Endogen (@endogen); the current version is v0.1.1.
More Skills