The "Ralph" technique turns AI agents into autonomous coding loops

The OpenHands webinar clip demystifies "Ralph," a technique that went viral after its creator, Jeffrey Huntley, demonstrated it building a complex codebase for a joke programming language called "cursed." The clip is careful to note that Ralph is not a prompt, plugin, or skill — it is a technique, and any "Ralph prompt" someone shares is merely a snapshot of their own journey with it. In its purest form, Ralph is a bash `while true` loop that runs an agent to completion in headless mode on the same prompt every single time. That prompt is a general-purpose "do-the-next-thing" instruction, allowing the agent to work through a plan autonomously across many iterations.

The presenter recommends replacing the infinite `while true` loop with a bounded iteration count — such as running for 10 cycles — as a safeguard for API costs.

For OpenHands users, the clip walks through practical CLI arguments: `-headless` for non-interactive background execution (which also implies auto-approval), `-f` to point the agent at the same prompt file each run, and `-json` to save raw logs for later inspection. The presenter recommends replacing the infinite `while true` loop with a bounded iteration count — such as running for 10 cycles — as a safeguard for API costs. When the agent stumbles, the developer inspects the logged failure modes and updates the process systemically rather than intervening mid-run. More advanced practitioners can graduate from the CLI to a custom Python orchestration script (referred to as a "Ralph hands" script), which can accept parameters like iteration count and other run configuration, tailored to each project's needs.

Key facts

1. 01Ralph is a technique created by Jeffrey Huntley, not a prompt, plugin, or skill.
2. 02At its core, Ralph is a bash `while` loop that runs an agent to completion on the same 'do-the-next-thing' prompt repeatedly.
3. 03The technique was first publicly demonstrated by Huntley building a compiler for a joke language called 'cursed.'
4. 04OpenHands CLI flags highlighted for Ralph usage include `-headless`, `-f` (to specify a prompt file), and `-json` (to save raw logs).
5. 05The presenter recommends replacing an infinite loop with a bounded iteration count (e.g., 10 runs) to control costs.
6. 06The core philosophy: observe failures and improve the system, not individual runs — developers design the environment, not the interaction.
7. 07Advanced users can move from CLI loops to a custom Python orchestration script with configurable parameters per project.

Topics