kookr-ralph-looplisted
Install: claude install-skill kookr-ai/kookr
# Kookr Ralph Loop
Use this skill when the user asks to use, start, attach, supervise, pause, resume, cancel, or inspect a Ralph loop in Kookr. Ralph loops are Kookr-managed task loops: Kookr re-injects the same prompt after each agent `Stop` event until a stop condition fires.
For the full operator playbook, see `.kookr/playbooks/ralph-loop.md`.
## When to Use
Use a Ralph loop when:
- The task benefits from repeated attempts with the same instruction, such as iterative cleanup, exploration, test-fix cycles, or work that can be judged by a simple predicate.
- There is a clear hard iteration cap.
- There is a concrete stop signal, such as a shell predicate, zero-diff convergence, a cost cap, or manual cancellation.
- The agent can persist progress in files so each iteration knows what remains.
Do not use a Ralph loop when:
- The user needs a one-off answer, design discussion, or approval-gated decision.
- The next step depends on fresh human judgment after each iteration.
- The prompt is likely to perform destructive operations without review.
- There is no bounded cap or observable stop condition.
- The standalone `ralph-wiggum@*` Claude Code plugin is enabled; Kookr's API refuses to start a loop when it detects that plugin because both controllers would react to the same `Stop` events.
## Basic Flow
1. Launch or identify the task that should be looped.
Existing tasks can be found in the dashboard or from the API:
```bash
curl http://localhost:4800/api/tas