@jimmyzhang95/codex-ralph-loop
v0.1.0
Published
Codex-native Ralph Loop runner, plugin, and installable skill for continue-until-done workflows.
Maintainers
Readme
Codex Ralph Loop
Codex Ralph Loop is a Codex-native version of the Ralph Loop pattern: one task, many focused codex exec passes, automatic continue-until-done behavior, and persistent local state between iterations.
What It Does
- Re-launches
codex execuntil the task is done, failed, or capped - Persists loop state under
.codex-ralph-loop/runs/ - Stores each iteration's prompt, final message, stdout, and stderr
- Ships as both a Codex plugin bundle and a user-installable global skill
Install
npx @jimmyzhang95/codex-ralph-loop installThen restart Codex.
Use
Create a prompt file:
Build the feature in small safe steps.
Keep going until the task is complete.
If more work remains after one pass, leave a concrete next prompt for the next iteration.Run the loop:
npx @jimmyzhang95/codex-ralph-loop run --prompt-file ralph-task.txtResume a previous run:
npx @jimmyzhang95/codex-ralph-loop resume <run-id>Inspect install health:
npx @jimmyzhang95/codex-ralph-loop doctorPublish Checklist
npm run build
npm test
npm publish --access public