← ClaudeAtlas

kookr-ralph-looplisted

Start, observe, pause, resume, or cancel Kookr's first-class Ralph iteration loops for task-scoped repeated agent work
kookr-ai/kookr · ★ 2 · AI & Automation · score 71
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