🔄 ralph-workflow

Scaffold everything you need to run Ralph safely inside a VS Code Dev Container with isolated GitHub credentials and an autonomous AI coding loop.

Get Started GitHub ↗

Why ralph-workflow?

Scaffold ralph script fast

Works with Claude, Codex, Gemini, and Opencode. Pick your AI CLI during setup; ralph.sh pipes the same prompt loop to whichever you choose.

Dev Container Templates

Leveraging VSCode Dev container to provide isolation for ralph loop. scaffold template pre-configures isolation, dependency, scripts to start coding immediately.

Credential Isolation

ralph-workflow provides convenience to passing github PAT token if ralph needs it, perform credential cleaning within container programmatically

Ralph Task Loop

Define stories in prd.yaml, run ralph.sh, and watch the agent implement, test, commit, and mark each story done — all without you touching the keyboard.

More about how it works ➡️

Quick Start

$ npx ralph-workflow

? Set up VS Code Dev Container for isolation? (Y/n) Y
? Choose a Dev Container template: Node 20
? Set up GitHub repository with isolated PAT? (Y/n) Y
  → Open https://github.com/settings/personal-access-tokens/new
  → Select only this repository, grant Contents: write
? Paste your PAT: **********************************

✓ .devcontainer/devcontainer.json written
✓ scripts/ralph/ scaffolded
✓ PAT stored at ~/.ralph-pat

Reopen this folder in the Dev Container to start.

Then edit scripts/ralph/prd.yaml, run ./scripts/ralph/ralph.sh 25, and let Ralph do the rest, safely in isolated environment Full guide →