š 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.
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. Scaffolded templates pre-configure isolation, dependencies, and auto-install RTK with rtk init already run for your chosen CLI so token-reduction kicks in on first boot. For Claude, opt in to the Caveman debug plugin and the awesome-claude-code-subagents collection.
Credential Isolation
ralph-workflow provides convenience to passing github PAT token if ralph needs it, perform credential cleaning within container programmatically. GitHub setup is now independent from the Dev Container ā pick either, both, or neither.
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.
Quick Start
$ npx ralph-workflow
? Which AI coding CLI? (claude/codex/gemini/opencode) claude
? Set up VS Code Dev Container for isolation? (Y/n) Y
? Set up GitHub repository with isolated PAT? (Y/n) Y
? Install Caveman debugging plugin? (y/N) n
? Install curated awesome-claude-code-subagents collection? (y/N) n
? Choose a Dev Container template: Node 20
ā Open https://github.com/settings/personal-access-tokens/new
ā Select only this repository, grant Contents: write
? Paste your PAT: **********************************
ā .devcontainer/devcontainer.json written
ā RTK + rtk init queued in postCreateCommand
ā scripts/ralph/ scaffolded
ā PAT stored at .ralph/token (gitignored, mode 0600)
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 ā