{
  "markdown": "# Ralph Wiggum Extension for Gemini CLI\n\n![Ralph Wiggum Gemini CLI](ralph-gemini-cli.png)\n\nRalph Wiggum extension for Gemini CLI implements iterative, self-referential development loops. Named after Ralph Wiggum from The Simpsons, it embodies persistent iteration despite setbacks.\n\n## What is Ralph?\n\nRalph is a development methodology based on continuous AI agent loops. The technique creates a self-referential feedback loop where Gemini iteratively improves its work until completion.\n\n## Installation\n\nInstall the Ralph extension by running *(requires Gemini CLI v0.4.0 or newer)*:\n\n```bash\ngemini extensions install https://github.com/AsyncFuncAI/ralph-wiggum-extension --auto-update\n```\n\nThe `--auto-update` is optional: if specified, it will update to new versions as they are released.\n\n## Usage\n\n### Start a Ralph Loop\n\n```bash\n/ralph-loop Build a REST API for todos --completion-promise 'DONE' --max-iterations 20\n```\n\n### Options\n\n- `--max-iterations <n>` - Stop after N iterations (default: unlimited)\n- `--completion-promise '<text>'` - Phrase that signals completion (quote multi-word phrases)\n\n### Cancel a Loop\n\n```bash\n/cancel-ralph\n```\n\n## Examples\n\n```bash\n# Basic loop with iteration limit\n/ralph-loop Fix the auth bug --max-iterations 10\n\n# Loop with completion promise\n/ralph-loop --completion-promise 'ALL TESTS PASSING' Add unit tests\n\n# Unlimited loop (use with caution)\n/ralph-loop Refactor the cache layer\n```\n\n## How It Works\n\n1. `/ralph-loop` creates a state file at `.gemini/ralph-loop.local.md`\n2. Gemini works on the task iteratively\n3. Each iteration, progress is made and tracked\n4. Loop ends when:\n   - Max iterations reached, OR\n   - Completion promise is genuinely true and output\n\n## State File\n\nMonitor progress:\n```bash\ncat .gemini/ralph-loop.local.md\n```\n\n## Philosophy\n\n- **Iteration > Perfection**: Don't aim for perfect on first try\n- **Failures Are Data**: Use them to improve\n- **Persistence Wins**: Keep trying until success\n- **Trust the Process**: Don't circumvent with false completion\n\n## Resources\n\n- [Original Ralph Technique](https://ghuntley.com/ralph/)\n- [Gemini CLI](https://github.com/google-gemini/gemini-cli)\n- [Gemini CLI Extensions](https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md)\n\n## License\n\nApache License 2.0\n\n",
  "bytes": 2309,
  "sha": "0cdf2f2709d194aafa071f14d3a85d5ca06e5057ef2ab8786977fd2d80614e4f",
  "repo_slug": "asyncfuncai/ralph-wiggum-extension",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_asyncfuncai_ralph_wiggum_extension_d69d4123/readme"
}