Skip to content
TakoAPI
Back to skills

monitored-ralph-loop

by endogen

DevOps & Cloud
999Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Generate copy-paste bash scripts for Ralph Wiggum/AI agent loops (Codex, Claude Code, OpenCode, Goose)

Description

What This Skill Does

Generates copy-paste bash scripts for running AI coding agent loops using Codex, Claude Code, OpenCode, or Goose. Manages iterative planning and building through structured markdown files (PROMPT.md, AGENTS.md, IMPLEMENTATION_PLAN.md) with event-driven notifications when the agent needs human input or hits a blocker.

Combines clean per-iteration sessions, file-based memory, and notification routing in one script so long-running agent jobs don't silently fail or exceed context limits.

When to Use It

  • Running an overnight Codex build session that notifies on completion
  • Generating a planning pass that breaks a feature into atomic tasks before writing code
  • Setting up parallel feature branches with independent agent sessions via git worktrees
  • Routing agent decisions back to a human when the agent hits an ambiguous requirement
  • Automating lint and test backpressure after each iteration so the codebase stays green

Example Workflow

INPUT

User asks: Generate a Ralph loop for building a FastAPI CRUD app using Codex, max 20 iterations, PLANNING then BUILDING

AGENT
  1. 1

    Creates specs/overview.md with goal, tech stack, and success criteria

  2. 2

    Generates AGENTS.md with install, test, lint, and run commands plus a Backpressure section

  3. 3

    Generates PROMPT.md in PLANNING mode instructing the agent to produce IMPLEMENTATION_PLAN.md without writing code

  4. 4

    Generates PROMPT.md variant for BUILDING mode instructing the agent to pick one task per iteration, run backpressure, and commit on success

  5. 5

    Outputs ralph.sh with RALPH_CLI=codex and max iterations set to 20

OUTPUT

A ready-to-run project scaffold with ralph.sh, PROMPT.md, AGENTS.md, and specs/ that the user copies into their repo and executes

Requirements

  • Installed and authenticated CLI for your chosen agent: Codex (requires OpenAI API key), Claude Code (requires Anthropic account), OpenCode, or Goose

Installation

clawhub install endogen/monitored-ralph-loop

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links