ralphed
v2.2.0
Published
Autonomous AI agent workflow for Claude Code using the Ralph Wiggum method
Maintainers
Readme
██████╗ █████╗ ██╗ ██████╗ ██╗ ██╗███████╗██████╗
██╔══██╗██╔══██╗██║ ██╔══██╗██║ ██║██╔════╝██╔══██╗
██████╔╝███████║██║ ██████╔╝███████║█████╗ ██║ ██║
██╔══██╗██╔══██║██║ ██╔═══╝ ██╔══██║██╔══╝ ██║ ██║
██║ ██║██║ ██║███████╗██║ ██║ ██║███████╗██████╔╝
╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝ ╚═╝╚══════╝╚═════╝Autonomous AI agent workflow for Claude Code using the Ralph Wiggum method.
Quick Start
npx ralphedThis will:
- Ask for a project directory (default:
./plans) - Ask for your PRD or project outline document
- Optionally auto-generate features from your PRD using Claude Code
- Set up all the files you need
What You Get
plans/
├── ralphed.sh # Main execution script (Sonnet default, Opus fallback)
├── ralphed-features.json # Feature list (auto-generated or template)
├── PRD.md # Your project requirements
├── logs/ # Execution logs (gitignored)
└── .gitignoreModel Switching
Uses Sonnet by default for speed/cost. Automatically switches to Opus when:
- A feature has
"model": "opus"in the JSON - Claude outputs
<signal>NEEDS_OPUS</signal>(self-escalation) - Sonnet fails on an iteration
Usage
After setup, run:
cd plans
./ralphed.sh 10 # Run 10 iterationsRequirements
- Node.js 18+
- Claude Code CLI (for auto-generation and execution)
Credits
License
MIT
