ruvnet avatar

Autopilot Loop

This is the orchestration layer for autonomous work sessions in Claude Code. It runs a continuous loop that checks task status, predicts the next best action, executes it (whether that's spawning an agent or editing code), then schedules itself to wake up in 270 seconds to do it again. The timing is deliberate: staying under the 300 second cache TTL keeps your prompt context warm between iterations. It pulls tasks from multiple sources including Claude's native TaskList, MCP task lists, and even markdown checkboxes in your project files. Useful when you want to kick off a development session and let Claude work through a backlog without manual intervention between each step.

skills.sh installs
753
GitHub stars
81.4K
last updated
Aug 21, 2026

Install

$ npx -y skills add ruvnet/ruflo --skill autopilot-loop --agent claude-code

Installs into .claude/skills of the current project.

Files

Run one autopilot iteration using Claude Code's native /loop:

  1. Check status: mcp__plugin_ruflo-core_ruflo__autopilot_status
  2. If all tasks complete or max iterations reached, call mcp__plugin_ruflo-core_ruflo__autopilot_disable and stop
  3. Get prediction: mcp__plugin_ruflo-core_ruflo__autopilot_predict for the optimal next action
  4. Execute the predicted task (spawn agent, edit code, run tests, etc.)
  5. Log via mcp__plugin_ruflo-core_ruflo__autopilot_log
  6. Schedule next: ScheduleWakeup({ delaySeconds: 270, reason: "next autopilot iteration" })

Cache-Aware Scheduling

Always use delay 270s (under 300s cache TTL) to keep the prompt cache warm between iterations.

Task Sources

Autopilot discovers tasks from:

  • team-tasks: Claude Code TaskList entries
  • swarm-tasks: MCP task_list entries
  • file-checklist: Markdown checkbox items in tracked files

Configure: mcp__plugin_ruflo-core_ruflo__autopilot_config({ taskSources: ["team-tasks", "swarm-tasks"] })

Sponsors

Details

Repository
github.com/ruvnet/ruflo
Category
Automation & Workflows
First seen
Jun 3, 2026

More from ruvnet/ruflo

All 236
1basicmachines-co avatarmemory-reflectbasicmachines-co/basic-memory-skillsSleep-time memory reflection: review recent conversations and daily notes, extract insights, and consolidate into long-term memory. Use when triggered by cron, 750skills.sh installs
2mhattingpete avatarflowchart-creatormhattingpete/claude-skills-marketplaceCreate HTML flowcharts and process diagrams with decision trees, color-coded stages, arrows, and swimlanes. Use when users request flowcharts, process diagrams,749skills.sh installs
3ruvnet avatardoc-genruvnet/rufloGenerate and maintain documentation with drift detection. Use when the user asks to write/update/refresh docs, detect doc drift against code, or schedule recurr744skills.sh installs
4ruvnet avatarcreate-pluginruvnet/rufloScaffold a new Claude Code plugin with proper directory structure, plugin.json, skills, commands, and agents743skills.sh installs
5posit-dev avatarrelease-postposit-dev/skillsCreate professional package release blog posts following Tidyverse or Shiny blog conventions. Use when the user needs to: (1) Write a release announcement blog 737skills.sh installs
6posit-dev avatarr-cli-appposit-dev/skillsBuild command-line apps in R using the Rapp package. Use when creating a CLI tool in R, adding argument parsing to an R script, turning an R script into a comma736skills.sh installs