#7272nd of 73 in Skills, plugins and rules

ralph

Bash loop that reruns Amp or Claude Code until every PRD story passes

Documentation ↗ Repository on GitHub ↗

Stars: 22k
License: MIT
Last commit: Feb 2026
Language: TypeScript

Stars, last 29 weeks+8,534

13,429 on 25 Mar 202621,963 on 14 Oct 2026

From GitHub's daily star counts.

Checked 15 Oct 2026 on GitHub.

Overview

Ralph is a bash script (ralph.sh) that repeatedly launches Amp or Claude Code with a fresh context, each time picking the highest-priority story in prd.json where passes is false. It implements one story, runs typecheck and tests, commits on success, and records learnings in progress.txt and AGENTS.md. It also ships prd and ralph skills for writing a PRD and converting it to prd.json.

Who it is for: Developers who want unattended coding-agent runs against a PRD task list

Strengths

Fresh context each iteration; state persists only in git, progress.txt and prd.json
Supports both Amp and Claude Code via a --tool flag
Small footprint: one shell script, prompt templates and two skills, plus jq
Installable as a Claude Code plugin marketplace entry

Weaknesses

Needs working typecheck and tests; broken checks compound across iterations
Stories must fit one context window; large ones must be split by hand
Requires an authenticated Amp or Claude Code install, which are separate tools
No tagged releases; default cap is 10 iterations

What it needs

no GPU
Needs Amp CLI or Claude Code, jq, git
Models: Amp, Claude Code

Also in Skills, plugins and rules

See all 73

Also in Skills, plugins and rules
Rank	Project	Score
1	skillsAgent skills for planning, TDD, debugging and code review291.3k starsMIT	94 out of 100
2	eccAgents, skills, hooks and rules bundle for Claude Code, Codex and other harnesses279.5k starsMIT	94 out of 100
3	cavemanCuts token use in coding agents with terse replies and compressed inputs Live demo ↗ (opens in a new tab)111.9k starsApache-2.0	93 out of 100
#4	ponytailSkill prompt that makes coding agents write less code and add tests163.6k starsMIT	92 out of 100
#5	ui-ux-pro-max-skillDesign-system skill that gives coding agents searchable UI styles, palettes and fonts135.9k starsMIT	91 out of 100

How to choose

Check which agent it targets and whether it works with the version you run.
Read what it adds to every prompt; big rule sets cost tokens on each call.
Prefer add-ons you can turn off per project.

Health

Releases: No GitHub releases
Top contributor: 53% of commits8 of 15 in the last 12 months
Security advisories: NoneOn GitHub, in the last 12 months
OpenSSF Scorecard: Not checked

Read from GitHub, deps.dev and OpenSSF on 15 Oct 2026. Bots and coding-agent accounts are left out of the commit counts. Not part of the score: how we check.

License in plain words

MIT Permissive

Use it at work: Yes
Change it and rebrand it: Yes
Sell it or host it for others: Yes

Your part: Keep the copyright and license notice in copies you ship.

A plain summary, not legal advice. Read the license on GitHub ↗ (opens in a new tab)

#72 of 73 in Skills, plugins and rules on Archestack, as of 15 Oct 2026.

In your README

The badge updates twice a day.

[![Archestack](https://archestack.com/badge/snarktank/ralph.svg)](https://archestack.com/best-of-vibe-coding/projects/ralph/)

How badges work

On your site or blog

A card with the rank, score and signals, in light or dark to match the reader.

<iframe src="https://archestack.com/embed/best-of-vibe-coding/ralph/" title="ralph on Archestack" width="400" height="270" style="border:0;max-width:100%" loading="lazy"></iframe>

Preview the card

Best of Vibe Coding on GitHub

Each review comes from the project's README and facts we check on GitHub. The fix form opens with ralph filled in.