Ralph

Ralph turns a natural-language goal into a PRD, then implements the work story by story using an AI coding backend.

Supported backends:

• pi
• OpenCode
• Claude Code
• Cursor Agent (agent)

Flow

1. optionally ask clarifying questions
2. generate a PRD
3. review the PRD
4. implement stories in priority/dependency order
5. run tests and retry failed stories

Requirements

• Go 1.24+
• Git
• One of the supported CLIs on PATH:
  • pi
  • opencode
  • claude
  • agent (Cursor Agent)

Install

go build -o ralph .
go install .

Usage

ralph "build a todo app"
ralph "build a todo app" --dry-run
ralph --resume
ralph status

Environment

Use RALPH_RUNNER to select the AI runner binary. Ralph does not pass a model to the runner; configure model selection in the runner itself.

Supported values:

pi
cursor
claude
opencode

Development

go test ./...
go build -o ralph .