snarktank/ralph
17,715 stars · Last commit 2026-02-02
Ralph is an autonomous AI agent loop that runs repeatedly until all PRD items are complete.
README preview
# Ralph  Ralph is an autonomous AI agent loop that runs AI coding tools ([Amp](https://ampcode.com) or [Claude Code](https://docs.anthropic.com/en/docs/claude-code)) repeatedly until all PRD items are complete. Each iteration is a fresh instance with clean context. Memory persists via git history, `progress.txt`, and `prd.json`. Based on [Geoffrey Huntley's Ralph pattern](https://ghuntley.com/ralph/). [Read my in-depth article on how I use Ralph](https://x.com/ryancarson/status/2008548371712135632) ## Prerequisites - One of the following AI coding tools installed and authenticated: - [Amp CLI](https://ampcode.com) (default) - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (`npm install -g @anthropic-ai/claude-code`) - `jq` installed (`brew install jq` on macOS) - A git repository for your project ## Setup