soniccyclone/claude-ralphs

claude-ralph is a small CLI tool that runs a “ralph loop” for Claude Code but replaces the agent’s self-declared DONE with externally-verified success criteria. It’s for developers who use Claude to iteratively edit/build projects and want deterministic gates (tests, typechecks, Playwright scripts, size checks) to decide completion. Key features: - Composes a prompt from PROMPT.md, specs/, fix_plan.md and last verifier_report.md, runs Claude, then executes all executables in .ralph/verifiers/ in lexical order. - Verifiers are simple scripts: exit 0 = pass, nonzero = fail; their stdout/stderr become the feedback. All-green writes .ralph/DONE and exits. - Scaffolds .ralph/ layout, per-iteration logs, verifier_report.md, optional verifier metadata (blocking, timeout), installer, POSIX-compatible, recommends sandboxing. - Requirements: claude CLI on PATH and ANTHROPIC_API_KEY.

AI-related keywords found in this repo's description, topics, or README summary — grouped by category. Each badge links to the corresponding ranking detail page.