Open Ralph Wiggum is a CLI tool that runs an autonomous agent loop across multiple AI coding agents (OpenCode, Claude Code, Codex, Copilot CLI, Cursor Agent, Qwen Code). It supports tasks mode, status checks, and various configuration options via CLI flags.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Open Ralph Wiggum implements an autonomous agentic loop for coding tasks. It wraps supported AI coding agents in a persistent development loop, enabling iterative progress with access to previous outputs and git history.
How it works
The tool runs a loop where an agent processes a prompt, writes code, and re-runs iterations until completion. It maintains iteration state, supports different agents via a single workflow, and can operate in Modes like Tasks and Status. It provides options to monitor progress and inject context mid-loop.
Getting started
Prerequisites include Bun runtime and at least one AI coding agent CLI. Installation options provided:
- npm install -g @th0rgal/ralph-wiggum
- bun add -g @th0rgal/ralph-wiggum
- From source: clone and run install scripts
Commands demonstrate usage such as:
ralph "<prompt>" [options]
Common options include --agent, --max-iterations, --tasks, --status, --prompt-file, --prompt-template, and various model/backend controls. Environment variables allow configuring paths to agent CLIs and goal modes.
Quick Start examples
ralph "Create a hello.txt file with 'Hello World'." --max-iterations 5
ralph "Build a REST API for todos..." --max-iterations 20
ralph "Create a small CLI and document usage. Output <promise>COMPLETE</promise> when done." --agent claude-code --model claude-sonnet-4 --max-iterations 5
Installation details
- npm install -g @th0rgal/ralph-wiggum
- bun add -g @th0rgal/ralph-wiggum
- From source: git clone, install.sh or install.ps1 depending on OS
Recent releases
Latest releases (examples):
- v1.3.1 (2026-05-26): Adds qwen-code headless mode, updates docs, fixes model config detection
- v1.3.0 (2026-04-29): Adds Cursor Agent support, installer detection, and stream parsing fixes
- v1.2.2 (2026-02-22): Deduplicated code, narrowed types, config validation
- v1.2.1 (2026-02-13): Version bump to 1.2.1 (sync package and runtime --version output)
- v1.1.0 (2026-01-23): Multi-Agent Support and Tasks Mode
Traction
1870 stars, 142 forks, 8 open issues
Behind the repo
Not provided in the provided material
Caveats
License: MIT. Created 2026-01-06, last push 2026-06-02. Language: TypeScript. OpenIssues: 8.