Compounder: Fixed iterative loop plugin for Claude Code
npx claudepluginhub jero2rome/compounderFixed iterative loop plugin for Claude Code. Session-isolated, parallel-safe, multi-line prompt support. Based on the Ralph Wiggum technique.
"Play iterated games. All the returns in life, whether in wealth, relationships, or knowledge, come from compound interest." — Naval Ravikant
"The philosophers warn us not to be satisfied with mere learning, but to add practice and then training." — Epictetus
An iterative loop plugin for Claude Code that compounds your work across iterations.
Compounder runs Claude in a self-referential loop, feeding the same prompt back after each iteration. Each iteration sees the previous work in files, allowing Claude to:
Based on the Ralph Wiggum technique with critical bug fixes.
# Add as a marketplace
/plugin marketplace add jero2rome/compounder
# Install the plugin
/plugin install compounder@jero2rome-compounder
# Start a loop with max iterations and completion promise
/compounder:compound-loop "Build a REST API with tests" --max-iterations 20 --completion-promise "DONE"
# Claude works, iterates, and outputs <promise>DONE</promise> when complete
# Cancel if needed
/compounder:cancel-compound
| Command | Description |
|---|---|
/compounder:compound-loop | Start an iterative loop |
/compounder:cancel-compound | Cancel the active loop |
/compounder:help | Show help and examples |
| Option | Description |
|---|---|
--max-iterations <n> | Stop after N iterations (default: unlimited) |
--completion-promise "<text>" | Phrase that signals completion |
1. /compound-loop "Your task" --max-iterations 20 --completion-promise "DONE"
2. Claude works on the task
3. Claude tries to exit
4. Stop hook intercepts, feeds SAME PROMPT back
5. Claude sees previous work in files
6. Repeat until <promise>DONE</promise> or max iterations
| Issue | Ralph Wiggum | Compounder |
|---|---|---|
| Parallel sessions | Conflicts (shared state file) | Isolated by session_id |
| Multi-line prompts | Breaks (bash arg parsing) | Works (stdin/heredoc) |
| Path handling | Relative paths (fragile) | Absolute via CLAUDE_PROJECT_DIR |
"Compound interest is a very powerful concept. Compounding in your reputation, in your knowledge, in your skills."
Each loop iteration compounds on the previous. Small improvements accumulate into significant results.
"For as time passes we forget what we learned and end up doing the opposite."
The loop enforces deliberate practice - Claude must repeatedly confront the task until mastery.
"Tinkering and iterations are much more antifragile than blueprints and hard plans."
Iteration beats perfection. Let the loop discover solutions through trial and error.
Good for:
Not good for:
# View current iteration
grep '^iteration:' .claude/compounder-*.local.md
# View full state
head -10 .claude/compounder-*.local.md
MIT License - see LICENSE