By jero2rome
Fixed iterative loop plugin for Claude Code. Session-isolated, parallel-safe, multi-line prompt support. Based on the Ralph Wiggum technique.
npx claudepluginhub jero2rome/compounder --plugin compounderCancel active compound loop
Start a compound loop in current session
Get help with the compounder plugin
Initialize a new feature workflow with git worktree
Run a task with automatic iteration until completion
Show current compound loop status
Use when the user wants to execute tasks autonomously, run compounder on a tasks.md file, start autonomous development, compound through a task list, or implement tasks iteratively. Guides autonomous task execution using compound loops.
Use when the user has an idea to brainstorm, wants to design a feature, needs help refining a concept, says "let's ideate", or describes a vague project needing structure. Guides structured brainstorming to produce a clear feature description ready for speckit.
Initialize a new feature workflow with git worktree. Use when the user wants to start a new feature, create an isolated development branch, says "init worktree", or needs to set up a feature branch for compounder workflow.
"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
Qiushi Skill: methodology skills for AI agents guided by seeking truth from facts, with Claude Code, Cursor, OpenClaw, Codex, OpenCode, and Hermes guidance.
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Intelligent prompt optimization using skill-based architecture. Enriches vague prompts with research-based clarifying questions before Claude Code executes them
Persistent memory system for Claude Code - seamlessly preserve context across sessions
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.