🤖Ralph
Ralph is an autonomous AI agent loop that runs repeatedly until all PRD items are complete.
⭐ Very popular: 21k stars, gaining about 105 a week
View on GitHub ↗repo profile
momentum
durability
since we covered it
why it's a big deal
- Ralph automates the grind of working through a product requirements document by running an AI coding tool in a loop until every user story passes, so a developer can hand off a batch of tasks rather than prompting story by story.
- Progress survives across iterations through git history, a progress.txt log, and a prd.json state file, which means work is inspectable and resumable rather than trapped in a single chat session.
- It commits only after typecheck and tests pass, and stops when all stories pass or after a default of 10 iterations, giving guardrails against runaway or broken changes.
under the hood
- Each iteration spawns a fresh AI instance with clean context using either Amp or Claude Code, so state lives in git, progress.txt, and prd.json rather than in a growing conversation.
- The loop picks the highest-priority story marked passes: false in prd.json, implements that one story, runs quality checks, then flips it to passes: true and appends learnings to progress.txt.
- Built mostly in TypeScript with shell scripting, it depends on git, jq for JSON, and a separately installed AI CLI, and ships as copyable files, global Amp or Claude skills, or a Claude Code marketplace plugin.
Radar summary, generated from the project's public sources
star history
- PR#26 8k 2026-01-28
- now 21k + 14k since first covered
curve is sampled from GitHub's star history, plus our own daily readings since we covered it; the dashed stretch is before we first covered it, the solid line since. figures at coverage are the numbers we printed then (approx.), current count is live.
understory
Better known than its recent output, coasting a little on attention.
- output, commits & releases
- clout, star velocity
output = commits & releases; clout = star velocity, both 0 to 100 monthly indices; the gap where output runs above clout is the understory. The understory →
covered in
-
Autonomous agent loop for Amp and Claude Code
similar projects
compare these →- 🦀 OpenClaw
18× the stars
Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
386k ACTIVE - 🥧 pi-mono
4.2× the stars
AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI
91k ACTIVE - 📎 paperclip
3.6× the stars
The open-source app everyone uses to manage agents at work
78k ACTIVE
comments
Sign in with GitHub to add your blip on Ralph.