Autonomous Development

The Ralph technique, without learning the Ralph technique

All the power of autonomous AI development. None of the setup. 

curl -fsSL https://raw.githubusercontent.com/whatiskadudoing/ralph-vibe/main/install.sh | sh
Get Started View on GitHub

What is Ralph Vibe?

Setting up the Ralph Wiggum technique for autonomous AI development is complex and time-consuming. You need specifications, implementation plans, build prompts, and a structured workflow.

Ralph Vibe handles all of that automatically.

Have an idea you want to validate? Run the interview, then go grab a beer. Meet friends. Play a video game. Ralph works autonomously in the background—writing code, running tests, iterating—until it's done.

Come back later and see your idea brought to life. 🍺

How It Works

01

Interview

Ralph asks what you want to build

02

Specs

Your answers become precise specifications

03

Plan

Tasks are generated from specs

04

Build

Autonomous loop builds and tests until done

Commands

ralph init

Initialize a new project or integrate with existing code. Add --vibe to run the full pipeline automatically.

ralph start

Interactive interview to understand your project and generate specifications.

ralph spec

Add new features via interview. Use -f "feature" to skip the interview.

ralph plan

Analyze specs and create an implementation task list with file linkage.

ralph work

Execute the autonomous build loop. One task per iteration until tests pass.

--vibe

Chain commands automatically: init → start → plan → work

Why Ralph Vibe?

01

Fresh Context

Each iteration starts clean. No accumulated confusion from long sessions.

02

Specs as Truth

What's in specs/ is what gets built. No ambiguity.

03

Atomic Tasks

One task per iteration. No partial implementations.

04

Test-Driven

Tasks only complete when tests pass. Quality enforced automatically.

05

File Persistence

All state lives in files. Survives context resets across sessions.

Quick Start

Prerequisites

Installation

curl -fsSL https://raw.githubusercontent.com/whatiskadudoing/ralph-vibe/main/install.sh | sh

Verify Installation

ralph --version

Start Building

ralph init --vibe

This will initialize your project, conduct an interview to gather requirements, generate an implementation plan, and begin the autonomous work loop.

FAQ

Do I need a Claude Pro subscription? +
Yes. Ralph Vibe uses Claude Code under the hood, which requires an active Claude Pro or Team subscription.
Can I use Ralph Vibe with an existing project? +
Yes. Run ralph init in your project directory and it will integrate with your existing codebase.
What happens if a build fails? +
Ralph Vibe runs tests after each task. If tests fail, it attempts to fix the issues. You can also intervene manually and run ralph work to continue.
How is this different from using Claude Code directly? +
Ralph Vibe adds structure: specifications, task planning, and an autonomous loop. Claude Code is the engine; Ralph Vibe is the autopilot.
What files does Ralph Vibe create? +
It creates specs/ for specifications, IMPLEMENTATION_PLAN.md for tasks, AGENTS.md for configuration, and supporting prompt files.
Can I edit the generated files? +
Absolutely. Ralph creates the scaffolding; you own all the files. Edit specs, adjust the plan, customize as needed.