ralph-starter

The most complete Ralph Wiggum implementation.
Connect your tools. Run AI coding loops. Ship faster.

The easiest way to run Ralph Wiggum autonomous coding loops — pull specs from GitHub, Linear, Notion, Figma, and more, then let AI build it.

Integrations • Quick Start • Features • Docs

---

Most 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

---

Integrations

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

Want more integrations? PRs welcome! See CONTRIBUTING.md to get started.

---

Table of Contents

• Integrations
• Quick Start
• Features
• Commands
• Configuration
• Contributing

---

Key Features