{"id":40621819,"url":"https://github.com/snwfdhmp/awesome-ralph","last_synced_at":"2026-02-26T13:32:43.227Z","repository":{"id":333446704,"uuid":"1137340296","full_name":"snwfdhmp/awesome-ralph","owner":"snwfdhmp","description":"A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.","archived":false,"fork":false,"pushed_at":"2026-02-03T08:34:43.000Z","size":100,"stargazers_count":715,"open_issues_count":3,"forks_count":52,"subscribers_count":7,"default_branch":"master","last_synced_at":"2026-02-14T22:25:39.141Z","etag":null,"topics":["ai-coding","claude","claude-code","ralph","ralph-loop","ralph-wiggum","vibe-coding"],"latest_commit_sha":null,"homepage":"https://reddit.com/r/RalphCoding","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/snwfdhmp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"snwfdhmp","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2026-01-19T08:42:54.000Z","updated_at":"2026-02-14T20:04:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/snwfdhmp/awesome-ralph","commit_stats":null,"previous_names":["snwfdhmp/awesome-ralph"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/snwfdhmp/awesome-ralph","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snwfdhmp%2Fawesome-ralph","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snwfdhmp%2Fawesome-ralph/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snwfdhmp%2Fawesome-ralph/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snwfdhmp%2Fawesome-ralph/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/snwfdhmp","download_url":"https://codeload.github.com/snwfdhmp/awesome-ralph/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snwfdhmp%2Fawesome-ralph/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29860474,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-26T08:51:08.701Z","status":"ssl_error","status_checked_at":"2026-02-26T08:50:19.607Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-coding","claude","claude-code","ralph","ralph-loop","ralph-wiggum","vibe-coding"],"created_at":"2026-01-21T07:00:27.521Z","updated_at":"2026-02-26T13:32:43.187Z","avatar_url":"https://github.com/snwfdhmp.png","language":null,"funding_links":["https://github.com/sponsors/snwfdhmp"],"categories":["Workflows \u0026 Knowledge Guides 🧠","Other Lists","Others","Other","AI编程文档","工作流程与知识指南 🧠"],"sub_categories":["Ralph Wiggum","TeX Lists"],"readme":"\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.reddit.com/r/RalphCoding/\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/692be4b4-8bd9-4002-af29-9e65c5e6b61c\" width=\"1000\" alt=\"Ralph Wiggum AI Coding method\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n# Awesome Ralph [![Awesome](https://awesome.re/badge.svg)](https://awesome.re) [![Follow on X](https://img.shields.io/twitter/follow/snwfdhmp?style=social)](https://x.com/snwfdhmp)\n\n\u003e A curated list of resources about Ralph (aka Ralph Wiggum), the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.\n\nRalph is a technique created by [Geoffrey Huntley](https://ghuntley.com) for autonomous AI coding. The core concept is elegantly simple:\n\n```bash\nwhile :; do cat PROMPT.md | claude-code ; done\n```\n\n**Key principles:**\n- Run an AI agent repeatedly until a PRD/specification is complete\n- Progress persists in files and git history, not in context\n- Each iteration starts fresh with clean context\n- Use \"backpressure\" (tests, lints, type checks) to validate work\n- Philosophy: *\"Sit on the loop, not in it\"* — or as Huntley puts it: *\"deterministically bad in an undeterministic world\"*\n\n\u003e **Found this useful? ⭐️ Like this repo to help others discover it**\n\n## Contents\n\n- [Official Resources](#official-resources)\n- [Playbooks \u0026 Methodology](#playbooks--methodology)\n- [Implementations](#implementations)\n  - [Claude Code Plugins](#claude-code-plugins)\n  - [Standalone Implementations](#standalone-implementations)\n  - [Tool-Specific Implementations](#tool-specific-implementations)\n  - [Multi-Agent Systems](#multi-agent-systems)\n- [Tutorials \u0026 Guides](#tutorials--guides)\n- [Articles \u0026 Blog Posts](#articles--blog-posts)\n- [Videos \u0026 Podcasts](#videos--podcasts)\n  - [Videos](#videos)\n  - [Podcasts](#podcasts)\n- [Community](#community)\n  - [Hacker News Discussions](#hacker-news-discussions)\n  - [Tools \u0026 Directories](#tools--directories)\n  - [Ralph Communities](#ralph-communities)\n- [Related Tools](#related-tools)\n- [Support](#support)\n- [Contributing](#contributing)\n\n## Official Resources\n\nPrimary sources from Geoffrey Huntley, the creator of the Ralph technique.\n\n- [Ralph Wiggum as a 'Software Engineer'](https://ghuntley.com/ralph/) - The definitive introduction. Explains the bash loop, \"tuning like a guitar\" metaphor, and the economics of autonomous coding.\n- [Everything is a Ralph Loop](https://ghuntley.com/loop/) - Deeper philosophical exploration covering \"reverse mode\" clean-rooming, orchestrator patterns, and \"The Weaving Loom\" concept.\n- [Don't Waste Your Back Pressure](https://ghuntley.com/pressure/) - Technical deep-dive on backpressure — the art of rejecting invalid generations without creating too much resistance.\n- [I Ran Claude in a Loop for Three Months](https://ghuntley.com/cursed/) - Case study: Ralph built CURSED, a Gen Z slang-based programming language with LLVM compiler.\n- [Too Many Model Context Protocol Servers](https://ghuntley.com/allocations/) - Context allocation theory — Ralph minimizes allocation to avoid compaction events.\n\n## Playbooks \u0026 Methodology\n\nComprehensive implementation guides covering the **3 Phases, 2 Prompts, 1 Loop** workflow.\n\n- [How to Ralph Wiggum](https://github.com/ghuntley/how-to-ralph-wiggum) - Geoffrey Huntley's official playbook covering context management, sandboxing, and prompt patterns.\n- [ralph-playbook](https://github.com/ClaytonFarr/ralph-playbook) - Comprehensive methodology guide with diagrams, phase explanations, and \"signs \u0026 gates\" steering techniques.\n\n### The Core Workflow\n\n**Phase 1: Define Requirements** — Human + LLM conversation produces JTBD-aligned specifications\n**Phase 2: Planning Mode** — Gap analysis generates prioritized TODO list (no implementation)\n**Phase 3: Building Mode** — Implement from plan, run tests, commit, repeat\n\n### Essential File Structure\n\n```\nproject-root/\n├── loop.sh                    # Ralph loop script\n├── PROMPT_build.md            # Build mode instructions\n├── PROMPT_plan.md             # Plan mode instructions\n├── AGENTS.md                  # Operational guide (~60 lines max)\n├── IMPLEMENTATION_PLAN.md     # Prioritized task list (generated)\n├── specs/                     # Requirement specs (one per JTBD)\n└── src/                       # Application source code\n```\n\n## Implementations\n\n### Claude Code Plugins\n\n- [ralph-claude-code](https://github.com/frankbria/ralph-claude-code) - Claude Code with intelligent exit detection, rate limiting, circuit breaker, and semantic response analyzer.\n- [choo-choo-ralph](https://github.com/mj-meyer/choo-choo-ralph) - Beads-powered 5-phase workflow with structured specs, verified implementations, and compounding knowledge—per-project installation with fully customizable workflows.\n\n### Standalone Implementations\n\n- [snartank/ralph](https://github.com/snarktank/ralph) - PRD-driven task management with automatic branching, flowchart visualization, and auto-archiving.\n- [iannuttall/ralph](https://github.com/iannuttall/ralph) - Minimal file-based agent loop supporting codex/claude/droid/opencode.\n- [smart-ralph](https://github.com/tzachbon/smart-ralph) - Spec-driven development workflow. Transforms feature requests into structured specs (research, requirements, design, tasks) then executes them task-by-task autonomously.\n- [ralph-wiggum-bdd](https://github.com/marcindulak/ralph-wiggum-bdd) - A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop.\n- [ralph-orchestrator](https://github.com/mikeyobrien/ralph-orchestrator) - Rust orchestrator with 7 AI backends, Hat System for specialized personas, and interactive TUI mode.\n- [nitodeco/ralph](https://github.com/nitodeco/ralph) - CLI orchestration tool for PRD-driven development with sequential task execution and interactive terminal UI.\n\n### Tool-Specific Implementations\n\n- [ralph-wiggum-cursor](https://github.com/agrimsingh/ralph-wiggum-cursor) - Cursor implementation with token tracking, context rotation at 80k tokens, and interactive setup.\n- [opencode-ralph-wiggum](https://github.com/Th0rgal/opencode-ralph-wiggum) - OpenCode implementation with real-time status display, mid-loop context injection, and struggle detection.\n- [ralph (GitHub Copilot)](https://github.com/aymenfurter/ralph) - VS Code extension with visual Control Panel, Progress Timeline, and Fresh Chat Mode.\n- [ralph-tui](https://github.com/subsy/ralph-tui) - Terminal UI orchestrator connecting to task trackers with interactive PRD creation.\n- [Goose Ralph Loop Tutorial](https://block.github.io/goose/docs/tutorials/ralph-loop/) - Block's Goose implementation with cross-model review and recipe-based workflows.\n\n### Multi-Agent Systems\n\n- [ralph-loop-agent](https://github.com/vercel-labs/ralph-loop-agent) - Vercel's TypeScript SDK wrapper with verification callbacks and context summarization.\n- [multi-agent-ralph-loop](https://github.com/alfredolopez80/multi-agent-ralph-loop) - Multi-agent orchestration for complex projects requiring parallel work streams.\n\n## Tutorials \u0026 Guides\n\n- [Getting Started with Ralph](https://www.aihero.dev/getting-started-with-ralph) - Step-by-step quickstart with Claude Code + Docker by Matt Pocock.\n- [11 Tips for AI Coding with Ralph Wiggum](https://www.aihero.dev/tips-for-ai-coding-with-ralph-wiggum) - AFK coding, HITL Ralph, iteration caps, and progress tracking.\n- [The Ralph Wiggum Approach](https://dev.to/sivarampg/the-ralph-wiggum-approach-running-ai-coding-agents-for-hours-not-minutes-57c1) - Stop hook mechanism, troubleshooting, and Q\u0026A.\n- [The Real Ralph Wiggum Loop](https://thetrav.substack.com/p/the-real-ralph-wiggum-loop-what-everyone) - Clarifies original bash loop vs Anthropic plugin philosophy.\n- [Ralph Wiggum Guide](https://github.com/JeredBlu/guides/blob/main/Ralph_Wiggum_Guide.md) - Community-written comprehensive guide.\n- [Awesome Claude - Ralph Wiggum](https://awesomeclaude.ai/ralph-wiggum) - Resource page with additional tips and configuration examples.\n- [How to Build an Effective Long Running Agent Loop in 7 minutes.](https://x.com/dabit3/status/2013091003104727338?s=20) - Walks you through the entire process from creating a spec, building and polishing a PRD, to running the agent with frameworks like Claude Code, Codex, and OpenCode.\n\n## Articles \u0026 Blog Posts\n\n- [How Ralph Wiggum Went from The Simpsons to the Biggest Name in AI](https://venturebeat.com/technology/how-ralph-wiggum-went-from-the-simpsons-to-the-biggest-name-in-ai-right-now) - VentureBeat coverage on the cultural phenomenon.\n- [A Brief History of Ralph](https://www.humanlayer.dev/blog/brief-history-of-ralph) - Comprehensive timeline including Y Combinator hackathon story.\n- [Ralph Wiggum and AI Coding Loops](https://www.ishir.com/blog/312751/ralph-wiggum-and-ai-coding-loops-from-springfield-to-real-world-software-automation.htm) - From Springfield to real-world software automation.\n- [Ralph Wiggum Explained: The Claude Code Loop That Keeps Going](https://blog.devgenius.io/ralph-wiggum-explained-the-claude-code-loop-that-keeps-going-3250dcc30809) - Technical explainer of how and why it works.\n- [2026: The Year of the Ralph Loop Agent](https://dev.to/alexandergekov/2026-the-year-of-the-ralph-loop-agent-1gkj) - Predictions and analysis of the Ralph loop's impact on development.\n\n## Videos \u0026 Podcasts\n\n### Videos\n\n- [Ralph Wiggum Deep Dive with Geoffrey Huntley](https://www.youtube.com/watch?v=SB6cO97tfiY) - The definitive video. Live coding demo, history, and comparison of bash-loop vs stop-hook implementations.\n- [AI That Works Podcast Episode](https://www.youtube.com/watch?v=fOPvAPdqgPo) - 75-minute deep dive on why Ralph works — context windows, control loops, and applications.\n- [Matt Pocock's Ralph Overview](https://www.youtube.com/watch?v=_IK18goX4X8) - Popular practical overview grounded in kanban and requirements discovery.\n\n### Podcasts\n\n- [Inventing the Ralph Wiggum Loop - Dev Interrupted](https://linearb.io/dev-interrupted/podcast/inventing-the-ralph-wiggum-loop) - Geoffrey Huntley on context rot, compaction, and the $10.42/hour calculation.\n- [Inventing the Ralph Wiggum Loop (Transcript)](https://devinterrupted.substack.com/p/inventing-the-ralph-wiggum-loop-creator) - Full transcript of the Dev Interrupted episode.\n- [Ralph Wiggum Coding Agent Power Tools - BoundaryML](https://boundaryml.com/podcast/2025-10-28-ralph-wiggum-coding-agent-power-tools) - Deep dive into tooling and advanced techniques.\n- [Ralph Wiggum AI Agent Explained - Startup Ideas Podcast](https://www.podscan.fm/podcasts/the-startup-ideas-podcast/episodes/ralph-wiggum-ai-agent-explained-amp-how-to-use-it) - Accessible introduction for founders and builders.\n\n## Community\n\n### Hacker News Discussions\n\n- [We Put a Coding Agent in a While Loop](https://news.ycombinator.com/item?id=45005434) - Geoffrey Huntley participated; security concerns raised about default passwords.\n- [Ralph Wiggum as a Software Engineer](https://news.ycombinator.com/item?id=43817200) - Code quality critiques and maintainability debates.\n- [Original HN Discussion](https://news.ycombinator.com/item?id=44565028) - The discussion that helped popularize the technique.\n- [Tips Discussion](https://news.ycombinator.com/item?id=46547129) - Community tips and experiences thread.\n- [Ralph from First Principles (Video)](https://news.ycombinator.com/item?id=46587275) - Discussion around educational video content.\n- [What Happens After Ralph Wiggum?](https://news.ycombinator.com/item?id=46632445) - Exploring the future of autonomous coding patterns.\n\n### Tools \u0026 Directories\n\n- [Vibe Coding - Ralph Wiggum Loop](https://vibecoding.app/tools/ralph-wiggum-loop) - Tool directory entry with quick-start resources.\n\n### Ralph Communities\n\n- [r/ralphcoding](https://www.reddit.com/r/RalphCoding/) - A subreddit about Ralph Coding. Share your learnings, resources, achievements with the community.\n- [Ralph Discord](https://discord.gg/MUyRMqKcWx) - Discord community discussing Ralph methods/resources/achievements.\n\n## Related Tools\n\n- [Advanced Context Engineering for Coding Agents](https://github.com/humanlayer/advanced-context-engineering-for-coding-agents) - Techniques for optimizing context windows and prompts for autonomous agents.\n\n## Support\n\nIf this list helped you discover useful Ralph resources, please give it a ⭐️ star! It helps others find this collection.\n\n[![Stargazers repo roster for @snwfdhmp/awesome-ralph](https://reporoster.com/stars/snwfdhmp/awesome-ralph)](https://github.com/snwfdhmp/awesome-ralph/stargazers)\n\n## Contributing\n\nContributions welcome! Please read the [contribution guidelines](CONTRIBUTING.md) first.\n\nJoin the community on [Discord](https://discord.gg/MUyRMqKcWx) and [Reddit](https://www.reddit.com/r/RalphCoding/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnwfdhmp%2Fawesome-ralph","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsnwfdhmp%2Fawesome-ralph","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnwfdhmp%2Fawesome-ralph/lists"}