Vibe-Skills ralph-loop

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

install

source · Clone the upstream repo

git clone https://github.com/foryourhealth111-pixel/Vibe-Skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/foryourhealth111-pixel/Vibe-Skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/bundled/skills/ralph-loop" ~/.claude/skills/foryourhealth111-pixel-vibe-skills-ralph-loop && rm -rf "$T"

manifest: bundled/skills/ralph-loop/SKILL.md

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).