How asyncfuncai/ralph-wiggum-extension works
This is a Gemini CLI extension for running persistent, iterative development tasks. The documented workflow starts with a user invoking /ralph-loop in Gemini CLI, which creates a local loop state file; Gemini then works iteratively until the iteration limit or completion promise is met. /cancel-ralph is the separate cancellation entry point. The README documents these behaviors, but source excerpts are unavailable, so links to the shell scripts and details of their internal wiring are omitted.
Main entry points: ralph-loop.toml Start loop · cancel-ralph.toml Cancel loop
Components 7
Loop commands
- Start loop
commands/ralph-loop.toml - Cancel loop
commands/cancel-ralph.toml
Loop runtime
- Loop state
- Iterative work
commands/ralph-loop.toml - Completion conditions
commands/ralph-loop.toml
Other components
- User
- Gemini CLI
Connections 7
- User → Gemini CLI: invokes
- Gemini CLI → Start loop: dispatches
- Start loop → Loop state: creates
- Gemini CLI → Iterative work: performs
- Iterative work → Completion conditions: checks
- User → Cancel loop: invokes
- Cancel loop → Gemini CLI: cancels