Skip to content
Back to search

ralph-wiggum-extension

Ralph Wiggum Gemini CLI Extension

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/asyncfuncai--ralph-wiggum-extension/badge.svg)](/listings/asyncfuncai--ralph-wiggum-extension)

HTML

<a href="/listings/asyncfuncai--ralph-wiggum-extension"><img src="/api/listings/asyncfuncai--ralph-wiggum-extension/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install the Ralph extension by running *(requires Gemini CLI v0.4.0 or newer)*:

gemini extensions install https://github.com/AsyncFuncAI/ralph-wiggum-extension --auto-update

The `--auto-update` is optional: if specified, it will update to new versions as they are released.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 85 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Ralph Wiggum Extension for Gemini CLI
  2. ![Ralph Wiggum Gemini CLI](ralph-gemini-cli.png)
  3. Ralph Wiggum extension for Gemini CLI implements iterative, self-referential development loops. Named after Ralph Wiggum from The Simpsons, it embodies persistent iteration despite setbacks.
  4. ## What is Ralph?
  5. Ralph 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.
  6. ## Installation
  7. Install the Ralph extension by running *(requires Gemini CLI v0.4.0 or newer)*:
  8. ```bash
  9. gemini extensions install https://github.com/AsyncFuncAI/ralph-wiggum-extension --auto-update
  10. ```
  11. The `--auto-update` is optional: if specified, it will update to new versions as they are released.
  12. ## Usage
  13. ### Start a Ralph Loop
  14. ```bash
  15. /ralph-loop Build a REST API for todos --completion-promise 'DONE' --max-iterations 20
  16. ```
  17. ### Options
  18. - `--max-iterations <n>` - Stop after N iterations (default: unlimited)
  19. - `--completion-promise '<text>'` - Phrase that signals completion (quote multi-word phrases)
  20. ### Cancel a Loop
  21. ```bash
  22. /cancel-ralph
  23. ```
  24. ## Examples
  25. ```bash
  26. # Basic loop with iteration limit
  27. /ralph-loop Fix the auth bug --max-iterations 10
  28. # Loop with completion promise
  29. /ralph-loop --completion-promise 'ALL TESTS PASSING' Add unit tests
  30. # Unlimited loop (use with caution)
  31. /ralph-loop Refactor the cache layer
  32. ```
  33. ## How It Works
  34. 1. `/ralph-loop` creates a state file at `.gemini/ralph-loop.local.md`
  35. 2. Gemini works on the task iteratively
  36. 3. Each iteration, progress is made and tracked
  37. 4. Loop ends when:
  38. - Max iterations reached, OR
  39. - Completion promise is genuinely true and output
  40. ## State File
  41. Monitor progress:
  42. ```bash
  43. cat .gemini/ralph-loop.local.md
  44. ```
  45. ## Philosophy
  46. - **Iteration > Perfection**: Don't aim for perfect on first try
  47. - **Failures Are Data**: Use them to improve
  48. - **Persistence Wins**: Keep trying until success
  49. - **Trust the Process**: Don't circumvent with false completion
  50. ## Resources
  51. - [Original Ralph Technique](https://ghuntley.com/ralph/)
  52. - [Gemini CLI](https://github.com/google-gemini/gemini-cli)
  53. - [Gemini CLI Extensions](https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md)
  54. ## License
  55. Apache License 2.0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.