-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Description
Display Name
ralph-starter
Category
Workflows & Knowledge Guides
Sub-Category
Workflows & Knowledge Guides: Ralph Wiggum
Primary Link
https://github.com/multivmlabs/ralph-starter
Author Name
Ruben Marcus
Author Link
https://github.com/rubenmarcus
License
MIT
Other License
No response
Description
The original Ralph Wiggum CLI tool and autonomous coding loop orchestrator. One command to run AI coding agents in iterative loops until task completion, with auto-commit, PR creation, and validation between iterations. Orchestrates Claude Code, Cursor, Codex, Gemini CLI, Copilot, Amp, and OpenCode. Fetches specs directly from GitHub Issues, Linear tickets, Notion pages, and Figma designs. Features progressive context trimming across iterations, cost tracking, pause/resume, workflow presets, and an MCP server exposing all capabilities as tools. Also available as a Claude Code plugin marketplace.
Validate Claims
Install via npm install -g ralph-starter, then run ralph-starter --help to see all commands. The core value is the autonomous loop: give it a task or point it at a GitHub issue, and it spawns fresh agent processes iteratively — writing code, running validation (lint/build/test), committing, and repeating until done. No configuration beyond having a coding agent (Claude Code, Cursor, etc.) installed.
Specific Task(s)
Point ralph-starter at a GitHub issue and let it build autonomously: ralph-starter run --from github --task "owner/repo#123" --auto --commit --validate. It will fetch the issue as a spec, spawn a coding agent, iterate until the task is complete, and auto-commit each change.
Specific Prompt(s)
After installing, run: ralph-starter init in any project directory to scaffold the playbook, then ralph-starter run --task "Add a health check endpoint to the API" --auto --commit --validate to watch it loop autonomously until the feature is built, tested, and committed.
Additional Comments
ralph-starter is the tool that coined and popularized the Ralph Wiggum loop technique for autonomous AI coding. It's been actively maintained since early 2026 with 260+ merged PRs, integrations with 4 external platforms (GitHub, Linear, Notion, Figma), support for 8 coding agents, and a docs site at ralphstarter.ai. The plugin marketplace was just added for claudemarketplaces.com discovery.
Recommendation Checklist
- I have checked that this resource hasn't already been submitted
- It has been over one week since the first public commit to the repo I am recommending
- All provided links are working and publicly accessible
- I do NOT have any other open issues in this repository
- I am primarily composed of human-y stuff and not electrical circuits