{"data":{"slug":"frankbria-ralph-claude-code","name":"ralph-claude-code","tagline":"Autonomous AI development loop for Claude Code with intelligent exit detection","github_url":"https://github.com/frankbria/ralph-claude-code","owner":"frankbria","repo":"ralph-claude-code","owner_avatar_url":"https://avatars.githubusercontent.com/u/136862992?v=4","primary_language":"Shell","stars":9604,"forks":723,"topics":["ai","ai-agent","ai-agents","ai-development","ai-development-tools","claude-code","claude-code-cli","development-tools","development-workflow"],"archived":false,"github_pushed_at":"2026-07-18T02:33:21+00:00","maintenance_label":"Steady","stars_delta_30d":49,"url":"https://www.graphcanon.com/tools/frankbria-ralph-claude-code","markdown_url":"https://www.graphcanon.com/tools/frankbria-ralph-claude-code.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/frankbria-ralph-claude-code","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=frankbria-ralph-claude-code","description":"Autonomous AI development loop for Claude Code with intelligent exit detection","homepage_url":null,"license":"MIT","open_issues":33,"watchers":45,"ai_summary":"Ralph provides an autonomous AI development workflow focusing on the integration and management of PRDs, specifications, and requirements using Claude Code. It supports importing existing documents and assessing their completeness, generating plans where necessary.","readme_excerpt":"## Quick Start\n\nRalph has two phases: **one-time installation** and **per-project setup**.\n\n```\nINSTALL ONCE              USE MANY TIMES\n+-----------------+          +----------------------+\n| ./install.sh    |    ->    | ralph-setup project1 |\n|                 |          | ralph-enable         |\n| Adds global     |          | ralph-import prd.md  |\n| commands        |          | ...                  |\n+-----------------+          +----------------------+\n```\n\n---\n\n### Phase 1: Install Ralph (One Time Only)\n\nInstall Ralph globally on your system:\n\n```bash\ngit clone https://github.com/frankbria/ralph-claude-code.git\ncd ralph-claude-code\n./install.sh\n```\n\nThis adds `ralph`, `ralph-monitor`, `ralph-setup`, `ralph-import`, `ralph-queue`, `ralph-migrate`, `ralph-enable`, and `ralph-enable-ci` commands to your PATH.\n\n> **Note**: You only need to do this once per system. After installation, you can delete the cloned repository if desired.\n\n---\n\n# - .ralph/specs/requirements.md (technical specs)\n\n---\n\n# Configure your project requirements manually\n\n---\n\n## Importing Existing Requirements\n\nRalph can convert existing PRDs, specifications, or requirement documents into the proper Ralph format using Claude Code.\n\n---\n\n# Also import issue comments (e.g. when a plan was posted as a comment)\nralph-import --github-issue 42 --include-comments\n```\n\nThe issue title becomes the project name (slugified, e.g. `Add User Login` → `add-user-login`) and the issue body becomes the PRD content. `--github-issue` addresses an exact issue and cannot be combined with the filter flags below.\n\n---\n\n### Completeness Assessment and Plan Generation\n\nGitHub issues vary widely in detail. During import, Ralph scores the issue 0–100 for implementation readiness (acceptance criteria, task checklists, code examples, section structure, guidance keywords, length). Issues scoring below the threshold (default: 60) get an implementation plan generated by Claude Code before conversion — the plan is folded into the generated `fix_plan.md` tasks and preserved verbatim at `.ralph/specs/implementation-plan.md`.\n\n```bash\n\n---\n\n# Default: assess the issue, generate a plan only if it lacks detail\nralph-import --github-issue 42\n\n---\n\n# Always generate a plan, with a specific model\nralph-import --github-issue 42 --generate-plan --plan-model opus\n\n---\n\n# Never generate a plan (fails if the issue scores below the threshold)\nralph-import --github-issue 42 --no-generate-plan\n\n---\n\n## Docker Sandbox Execution\n\nRun Claude Code inside an isolated Docker container instead of directly on your machine (Issue #74). Ralph's loop, rate limiting, and monitoring stay on the host; only Claude's execution — the part that edits files and runs commands autonomously — is containerized. The project directory is bind-mounted read-write at `/workspace`, so changes land on the host directly and `ralph-monitor` works unchanged.\n\n---\n\n# ...or build it yourself (from a source checkout, or ~/.ralph after install)\ndocker build -t ralph-sandbox .\n```\n\n---\n\n## System Requirements\n\n- **Bash 4.0+** - For script execution\n- **Claude Code CLI** - `npm install -g @anthropic-ai/claude-code` (or use npx — set `CLAUDE_CODE_CMD` in `.ralphrc`)\n- **tmux** - Terminal multiplexer for integrated monitoring (recommended)\n- **jq** - JSON processing for status tracking\n- **Git** - Version control (projects are initialized as git repos)\n- **GNU coreutils** - For the `timeout` command (execution timeouts)\n  - Linux: Pre-installed on most distributions\n  - macOS: Install via `brew install coreutils` (provides `gtimeout`)\n- **Standard Unix tools** - grep, date, etc.\n\n---\n\n### Testing Requirements (Development)\n\nSee [TESTING.md](TESTING.md) for the comprehensive testing guide.\n\nIf you want to run the test suite:\n\n```bash\n\n---\n\n# Install BATS testing framework\nnpm install -g bats bats-support bats-assert\n\n---\n\n# Install coreutils (provides gtimeout)\nbrew install coreutils\n\n---\n\n# Verify installation\ngtimeout --version\n```\n\nRalph autom","github_created_at":"2025-08-27T16:03:45+00:00","created_at":"2026-07-07T17:41:21.740292+00:00","updated_at":"2026-08-20T06:01:14.544049+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"},{"slug":"developer-tools","name":"Developer Tools","url":"https://www.graphcanon.com/categories/developer-tools","markdown_url":"https://www.graphcanon.com/categories/developer-tools.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/developer-tools"}],"tags":[{"slug":"ai-agents","name":"ai-agents"},{"slug":"ai-development-tools","name":"ai-development-tools"},{"slug":"development-workflow","name":"development-workflow"}],"trust":{"provenance":{"is_fork":false,"github_id":1045721921,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-08-20T06:01:13.814Z","maintenance":{"label":"Steady","score":60,"methodology":"github_public_v1","releases_90d":0,"days_since_push":33,"last_release_at":null,"stars_delta_30d":49,"open_issues_delta_30d":5},"security_summary":{"status":"ok","scanner":"osv@v1","low_count":0,"high_count":0,"last_scan_at":"2026-07-11T11:18:58.214Z","medium_count":0,"scan_profile":"deps","critical_count":0}},"capability_facts":{"mcp":{"source":"repo_scan","observed_at":"2026-08-20T06:01:14.256Z","server_manifest":false},"scan":{"source":"repo_scan","observed_at":"2026-08-20T06:01:14.256Z"},"deploy":{"source":"dockerfile:Dockerfile","self_host":true,"observed_at":"2026-08-20T06:01:14.256Z","managed_saas":false},"languages":{"value":["shell","javascript"],"source":"github.language+package.json","observed_at":"2026-08-20T06:01:14.256Z"},"has_docker":{"value":true,"source":"dockerfile:Dockerfile","observed_at":"2026-08-20T06:01:14.256Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-08-20T06:01:14.256Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":{"notes":["- Requires Bash 4.0+ for script execution.","- Claude Code CLI must be installed (`npm install -g @anthropic-ai/claude-code`).","- tmux, jq, Git, and GNU coreutils are required system utilities."],"min_ram_gb":null,"requires_docker":true},"constraints":{"min_ram_gb":null,"requires_docker":true},"when_to_use":["- When you already have existing PRDs, specifications, or requirement documents that need conversion into the Ralph format and completeness assessment using Claude Code.","- When you prefer working within a shell environment for automation of tasks such as PRD imports and workflow assessments."],"when_not_to_use":["- If your development process does not rely heavily on PRDs or structured documents for specifications, as Ralph's primary strength lies in managing these.","- If you don't want to integrate via an autonomous loop with intelligent exit detection, which is a key feature of Ralph compared to other workflow automation tools."],"source":"enrich:decision_facts","observed_at":"2026-07-11T16:03:50.631Z"},"constraint_facets":{"min_ram_gb":null,"requires_docker":true},"decision_summary":[{"label":"Requirements","value":"Requires Docker; - Requires Bash 4.0+ for script execution.; - Claude Code CLI must be installed (`npm install -g @anthropic-ai/claude-code`).; - tmux, jq, Git, and GNU coreutils are required system utilities."},{"label":"Adopt for","value":"Ralph provides an autonomous AI development workflow with intelligent exit detection specifically integrated to work with Claude Code."}]}}