First public release of ralph — a dependency-free Bash / PowerShell loop that runs an AI coding CLI (Codex, Claude Code, Gemini, Devin) in a fresh session each iteration for long, unattended runs.
Added
ralph-loop.sh— Bash loop that runs an AI coding CLI in a fresh session each iteration, feeding it the same prompt.ralph-loop.ps1— PowerShell counterpart with behavioural parity.- Live reload of
.ralph/.envconfiguration before each iteration. - Auto-switch of agent on token exhaustion (fixed rotation cycle).
- Hard RAM limit per iteration on Linux via transient
systemd-run --user --scope. stop.mdclean-stop signal.- Timestamped per-iteration logs in
.ralph/logs/with rotation. justfileinstall recipe and bundledjuez/maestro/ralphskills.
Notes
Originally authored by César Gallego Rodríguez (https://gitlab.com/gallego.cesar/ralph), published with the author's consent. Distributed and maintained by Santander AI Lab. Licensed under Apache-2.0.