GitHub - snarktank/ralph: Ralph is an autonomous AI agent loop that runs repeatedly until all PRD items are complete.
5 hours ago
- #autonomous agents
- #coding workflow
- #AI automation
- Ralph is an autonomous AI agent that repeatedly runs AI coding tools (Amp or Claude Code) to complete all items in a PRD, with memory persisted via git history, progress.txt, and prd.json.
- Setup requires installing an AI coding tool, jq, and having a git repo; then copy Ralph scripts and skills, and configure settings like auto-handoff for large contexts.
- Usage involves generating a PRD with the PRD skill, converting it to prd.json with the Ralph skill, and running the ralph.sh script to iteratively implement stories, run checks, and update status until all are complete.
- Each iteration uses a fresh AI instance with clean context, relying only on git history, progress.txt, and prd.json for memory, and stories must be small enough to fit in one context window.
- Ralph requires feedback loops like typechecking and tests, updates AGENTS.md with learnings for future iterations, and archives previous runs when starting new features.