@daonhan/ralph
v0.6.3
Published
CLI for the ralph AFK loop (ralph-afk, ralph-ghafk).
Maintainers
Readme
@daonhan/ralph
CLI for Ralph — a harness that drives the Claude Code CLI against a target repository in an iterating implementer → reviewer loop, inside an ephemeral Docker sandbox.
Exposes two bin entries (thin wrappers over
@daonhan/ralph-core):
ralph-afk— plan/PRD-driven loop. Iterates until the agent emits<promise>NO MORE TASKS</promise>.ralph-ghafk— GitHub-issue-driven loop. Pulls open issues and lets the agent pick the next task.
Security: Ralph runs Claude with
--permission-mode bypassPermissionsinside the sandbox and, by default, bind-mounts the host Docker socket (root-equivalent host access). Point it only at repositories and prompts you trust. See SECURITY.md.
Install
npm i -g @daonhan/ralphUse
cd /path/to/your/workspace
ralph-afk "<plan-and-prd>" 5 # plan/PRD loop
ralph-ghafk 5 # GitHub-issue loop
ralph-afk --help # flags, env vars
ralph-afk --print-config # diagnose workspace / docker context / image / socketRequires Docker and an authenticated Claude Code login (and gh for ralph-ghafk). First-run
setup, per-OS notes, and the full flag/env reference are in the
main README and
QUICKSTART.
License
MIT © Paul Nguyen.
