by multivmlabs
Bootstrap projects from Figma, Linear, Notion & GitHub specs. The only AI ralph with source integrations.
# Add to your Claude Code skills
git clone https://github.com/multivmlabs/ralph-starterMost AI coding tools work in isolation. You describe a task, AI builds it, done.
ralph-starter brings the Ralph Wiggum technique to production. It connects to your existing workflow — pulling specs from GitHub issues, Linear tickets, Notion docs, or any URL — then runs autonomous Ralph Wiggum loops until the task is complete. One command to go from spec to shipped code.
# Build from a GitHub issue
ralph-starter run --from github --project myorg/myrepo --label "ready"
# Build from a Linear ticket
ralph-starter run --from linear --project "Mobile App" --label "sprint-1"
# Build from a Notion spec
ralph-starter run --from notion --project "https://notion.so/Product-Spec-abc123"
# Or just describe what you want
ralph-starter run "build a todo app with React" --commit
ralph-starter integrates with your favorite tools out of the box:
| Integration | Auth Method | What It Fetches |
|-------------|-------------|-----------------|
| GitHub | gh CLI (recommended) or API token | Issues, PRs, files |
| Linear | linear CLI or API key | Issues by team/project |
| Notion | None (public) or API token (private) | Pages, databases |
| Figma | API token | Design specs, tokens, assets & content extraction |
| URLs | None | Any public markdown/HTML |
| Files | None | Local markdown, PDF |
# Check available integrations
ralph-starter integrations list
# Test connectivity
ralph-starter integrations test github
ralph-starter integrations test linear
# Preview data before running
ralph-starter integrations fetch github owner/repo
No comments yet. Be the first to share your thoughts!
Want more integrations? PRs welcome! See CONTRIBUTING.md to get started.
| Feature | Description | |---------|-------------| | Integrations | Pull specs from GitHub, Linear, Notion, Figma, URLs, files | | Multi-Agent Support | Works with Claude Code, Cursor, Copilot, Gemini CLI, and more | | Interactive Wizard | Guided project creation with AI-refined specifications | | 16+ Workflow Presets | Pre-configured modes: feature, tdd, debug, review, and more | | Circuit Breaker | Auto-stops stuck loops after repeated failures | | Cost Tracking | Estimates token usage and cost per iteration | | Git Automation | Auto-commit, push, and PR creation | | Backpressure Validation | Run tests/lint/build after each iteration | | MCP Server | Use from Claude Desktop or any MCP client |
# Simple task
ralph-starter run "build a todo app" --commit --validate
# With preset
ralph-starter run --preset tdd-red-green "add user authentication"
# With safety controls
ralph-starter run --rate-limit 50 --circuit-breaker-failures 3 "build X"
# Interactive wizard
ralph-starter
The Ralph Wiggum technique is an autonomous AI coding pattern where you run a coding agent (like Claude Code, Codex, or Cursor) in a loop — feeding errors back into the agent until the task is complete. Originally described by Geoffrey Huntley, the Ralph Wiggum loop has become one of the most popular approaches for autonomous AI development.
ralph-starter is the production-grade Ralph Wiggum implementation — it adds integrations, safety controls (circuit breakers, rate limiting, cost tracking), git automation, validation backpressure, and multi-agent support on top of the core Ralph Wiggum loop pattern. Instead of a bare bash script, you get a full orchestration engine.
Why ralph-starter over a raw Ralph Wiggum script?
npm install -g ralph-starter
# or
npx ralph-starter
After installing, run the setup wizard and verify your environment:
ralph-starter setup # Configure API keys and preferences
ralph-starter check # Verify system requirements and connectivity
Just run ralph-starter with no arguments to launch the interactive wizard:
ralph-starter
The wizard will:
ralph-starter ideas
This launches Idea Mode - a brainstorming session to help you discover project ideas:
# Run a single task
ralph-starter run "build a todo app with React"
# With git automation
ralph-starter run "add user authentication" --commit --pr
# With validation (backpressure)
ralph-starter run "refactor auth" --commit --validate
# Fetch specs from external sources
ralph-starter run --from https://example.com/spec.md
ralph-starter run --from github --project myorg/myrepo --label "ready"
ralph-starter run --from linear --project "Mobile App"
# Fetch a specific GitHub issue
ralph-starter run --from github --project owner/repo --issue 123
# Specify output directory (skips "where to run?" prompt)
ralph-starter run --from github --project owner/repo --issue 42 --output-dir ~/projects/new-app
ralph-starter automatically detects existing projects when you run the wizard:
Ralph Playbook Project (has AGENTS.md, IMPLEMENTATION_PLAN.md, etc.):
cd my-ralph-project
ralph-starter
The wizard will detect the Ralph Playbook files and let you:
Language Project (has package.json, pyproject.toml, Cargo.toml, go.mod):
cd my-existing-app
ralph-starter
The wizard will detect the project type and let you:
Launch with ralph-starter (no args) for a guided experience:
For users who don't know what to build yet:
ralph-starter ideas
Use ralph-starter from Claude Desktop or any MCP client:
ralph-starter mcp
Add to Claude Desktop config:
{
"mcpServers": {
"ralph-starter": {
"command": "ralph-starter",
"args": ["mcp"]
}
}
}
Available MCP Tools:
ralph_init - Initialize Ralph Playbookralph_plan - Create implementation planralph_run - Execute coding loopralph_status - Check progressralph_validate - Run tests/lint/buildWorks with your favorite coding agents:
ralph-starter supports multiple LLM