ralph

Installation
SKILL.md

Ralph — Autonomous Agent Runner

Ralph is a bash script that runs Claude autonomously to implement features from a PRD. It processes one user story per iteration, commits after each, and stops when the PRD is complete.


First-time Setup

When the user first invokes Ralph, check if the project is set up:

  1. If ralph.sh doesn't exist in the project root, create it from references/ralph-script.md (in this skill's directory)
  2. Make it executable: chmod +x ralph.sh
  3. Add to .gitignore if not already present: prd.json, progress.txt
  4. Create tasks/ directory if it doesn't exist
  5. Create empty progress.txt if it doesn't exist
  6. Verify jq is installed (which jq); if not, tell the user to install it (brew install jq)

Related skills
Installs
2
GitHub Stars
5
First Seen
Mar 7, 2026