# Ralphify

A command-line runtime for loop engineering that repeatedly drives a coding agent through a portable directory of instructions called a ralph loop.

Ralphify runs "ralph loops," an open, portable format for scripting an autonomous coding-agent loop. A ralph is a directory containing a required RALPH.md file with YAML frontmatter naming the agent command and the commands to run between iterations, plus any supporting files; because the format is standardized, a loop can be committed to a repository and run by anyone.

Each iteration starts the agent with a fresh context window and current data: ralphify runs the configured commands, fills placeholders in the prompt with their output, pipes the result to the agent, and loops until stopped. It works with any agent CLI, such as Claude Code, Codex or Pi, by changing one configuration field.

The project is kept for educational purposes and is not actively maintained; it is written in Python and installs with "uv tool install ralphify".

Website: https://ralphify.co/docs/