Skip to content
cccskills
FreePublished on GitHub

ralph-loop

Manage repeated work on a task in Codex with iteration limits, completion conditions, and saved progress. Advance iterations manually with the default engine, or use the optional open-ralph-wiggum command-line tool for automatic iteration.

OriginalShow the original description

Codex-compatible Ralph loop runner with dual engines (compat local state loop + optional open-ralph-wiggum backend).

See how to install

Good for

  • Starting repeated work with an iteration limit
  • Advancing to the next iteration manually
  • Checking the current loop state
  • Running automatic iterations through an external tool

Files included (2)

  • SKILL.md2.0 KB
  • scripts/ralph-loop.ps114.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

ralph-loop

This is a Codex-oriented ralph-loop command with two execution engines.

Engine model

  • Keeps the same command name: ralph-loop.
  • Keeps the same default state file format: .claude/ralph-loop.local.md.
  • Default compat engine keeps local-state semantics and manual --next.
  • Optional open engine delegates to external open-ralph-wiggum CLI for auto-iteration.

Script

  • Script path: scripts/ralph-loop.ps1

Usage

$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME '.codex' }
$script = Join-Path $codexHome 'skills/ralph-loop/scripts/ralph-loop.ps1'

# Start a local compat loop
powershell -ExecutionPolicy Bypass -File $script Build a todo API --max-iterations 20 --completion-promise DONE

# Move to the next iteration manually
powershell -ExecutionPolicy Bypass -File $script --next

# Show current loop state
powershell -ExecutionPolicy Bypass -File $script --status

# Force restart with a new prompt
powershell -ExecutionPolicy Bypass -File $script New prompt --max-iterations 10 --force

# Use open-ralph-wiggum backend (auto loop, defaults to --agent codex and --no-commit)
powershell -ExecutionPolicy Bypass -File $script --engine open Build a todo API --max-iterations 20 --completion-promise DONE

Vibe compatibility

  • Safe in /vibe routed sessions as a direct execution tool.
  • Does not force multi-agent orchestration.
  • Keeps command names stable for unified memory and invocation.
  • open engine remains mutually exclusive with active XL team orchestration.

Notes

  • Compat mode: if max_iterations is reached, the local state file is removed automatically.
  • Compat mode: completion promises are tracked in local state.
  • Open mode: --next, --force, --state-file, --stop are not available (managed by external ralph CLI semantics).

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

adaptyv

FreeSummary

Support experimental validation of designed proteins through a cloud laboratory. Prepare and optimize sequences, submit tests for binding, expression, thermal stability, or enzyme activity, track experiment progress, and retrieve results through the API.

  • Submit designed proteins for binding tests
  • Request expression, thermal stability, or enzyme activity tests
  • Optimize sequences for solubility before experiments
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

aeon

FreeSummary

Analyze time series, observations ordered over time, using aeon in Python. Build classification, prediction, and clustering workflows, detect unusual patterns or changes, and compare methods through an interface compatible with scikit-learn.

  • Classifying time series by their patterns
  • Forecasting future values from past observations
  • Detecting anomalies and change points
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

algorithmic-art

FreeSummary

Create original generative art with p5.js, using code to produce patterns and motion. Receive a written artistic concept and an interactive HTML viewer with adjustable parameters, reproducible random variations, seed navigation, and PNG downloads.

  • Create art from particle motion and flow fields
  • Explore patterns by adjusting sliders
  • Reproduce a favorite variation with the same seed
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

alpha-vantage

FreeSummary

Retrieve stock prices, exchange rates, cryptocurrency prices, company financial statements, and economic indicators through the Alpha Vantage API. It also covers historical data, news sentiment, and technical indicators, which summarize price and trading patterns.

  • Retrieve historical stock prices and trading volumes
  • Collect company financial statements and earnings data
  • Check foreign exchange and cryptocurrency prices
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

Design backend systems with clear boundaries between business rules, databases, and external services. Use Clean Architecture, Hexagonal Architecture, and Domain-Driven Design to organize new applications, refactor existing code, and make core logic easier to test.

  • Planning the structure of a new backend
  • Refactoring tightly coupled applications
  • Testing business rules independently of external services
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

astropy

FreeSummary

Helps process astronomical data in Python by converting coordinates, units, and time scales, working with FITS observation files, matching object catalogs, and calculating distances using cosmological models.

  • Converting celestial coordinates
  • Reading and editing FITS observation files
  • Matching objects across astronomical catalogs
foryourhealth111-pixel/Vibe-Skills3.8KUpdated Oct 23, 2026

See all skills by foryourhealth111-pixel

Report a problem with this skill