Plugin Official

ralph-loop

Self-referential loops via a Stop hook: same prompt repeated until a completion promise.

Author
Anthropic
Works with
Claude Code
License
Apache-2.0
Documented
Oct 2, 2026

What ralph-loop is

Implements the Ralph Wiggum technique inside the session: /ralph-loop blocks exit with a Stop hook and re-feeds the prompt.

What it does

How ralph-loop plugs in: which agents run it and what it addsRUNS INYour agentClaude Codeone host documentedPLUGIN · OFFICIALralph-loopBundles of skills, commands, hook…4 install steps1 permission notelicense: Apache-2.0WHAT IT ADDSWhat it does/ralph-loop runs a task with --co…Stop hook blocks exit and re-feed…Prior work persists in files and…Loops until completionagent → extension → new capability · from the official repository or docs
Where ralph-loop runs and what it adds, from its documentation
  • /ralph-loop runs a task with --completion-promise
  • Stop hook blocks exit and re-feeds the prompt
  • Prior work persists in files and git history
  • Loops until completion

When to use it

Good fit

  • Well-defined tasks with automatic verification

Not for

  • Tasks needing human judgement each step

How to install ralph-loop

You need: Claude Code

  1. Marketplace ships enabled by default in Claude Code; or browse via /plugin > Discover
  2. Install: /plugin install ralph-loop@claude-plugins-official
  3. Run the plugin's commands/agents as described in its README
  4. Trust check: Anthropic warns to trust a plugin before installing, as it cannot verify included MCP servers, files or software

Permissions and security

What it can access

  • Runs inside Claude Code; commands, agents and hooks use Claude Code's tool permissions (see plugin README for specifics)

Security notes from the maintainers

  • Marketplace README: make sure you trust a plugin before installing, updating, or using it

Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.

Tools it extends

Frequently asked questions

How do I install the ralph-loop plugin?

Run /plugin install ralph-loop@claude-plugins-official in Claude Code. source

Is the ralph-loop plugin made by Anthropic?

Yes, it is listed under /plugins (internal plugins developed by Anthropic) in the claude-plugins-official repo. source

What does the ralph-loop plugin add to Claude Code?

Self-referential loops via a Stop hook: same prompt repeated until a completion promise. source

Related guides

Sources and gaps

Not stated by the maintainers: last_release (not read); limitations not stated in README.

More extensions to look at