Skip to main content
AI/MLruvnet

loop-worker

Run Ruflo background workers using Claude Code native /loop scheduling

Stars
56,726
Source
ruvnet/claude-flow
Updated
2026-05-31
Slug
ruvnet--claude-flow--loop-worker
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/ruvnet/claude-flow/HEAD/plugins/ruflo-loop-workers/skills/loop-worker/SKILL.md -o .claude/skills/loop-worker.md

Drops the SKILL.md into .claude/skills/loop-worker.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Use /loop for in-session periodic workers. Cache-aware delays keep prompt cache warm:

  • Delay formula: min(270, cache_ttl * 0.9) -- default 270s

Dispatch a worker via MCP: mcp__claude-flow__hooks_worker-dispatch({ trigger: "WORKER_NAME" })

Then schedule the next iteration: ScheduleWakeup({ delaySeconds: 270, reason: "next WORKER_NAME iteration" })

Available Workers

Worker Interval Description
audit 270s Security analysis
optimize 270s Performance optimization
consolidate 600s Memory consolidation
predict 270s Predictive preloading
map 600s Codebase mapping
testgaps 270s Test coverage analysis
document 600s Auto-documentation
benchmark 600s Performance benchmarking

MCP tool responses include [LOOP_SUGGESTION] and [CRON_SUGGESTION] hints -- follow them.