ruflo-doctor

Diagnoses and auto-repairs common Ruflo installation issues via CLI health checks.

70.1k|8.4k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill ruflo-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ruflo-doctor
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-core/skills/ruflo-doctor
Command: npx skills add https://github.com/ruvnet/claude-flow --skill ruflo-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @claude-flow/cli.

What problem does it solve?

Ruflo installations can break due to outdated Node.js versions, invalid configs, stopped daemons, or corrupted memory databases, and manually diagnosing each component is tedious. This Skill runs a single health check command that detects and fixes these common issues automatically.

Core Features & Use Cases

  • Automated Health Checks: Verifies Node.js 20+, npm 9+, git, config validity, daemon status, memory database, API keys, MCP servers, disk space, and TypeScript.
  • Auto-Repair Mode: The --fix flag repairs detected problems without manual intervention.
  • Targeted Fixes: Supports focused repairs for memory initialization, daemon startup, and config resets.
  • Use Case: After upgrading Node.js, your Ruflo daemon stops responding. Run the doctor command to identify the stale daemon process and restart it automatically.

Quick Start

Ask the assistant to run the ruflo doctor health check with the fix flag to diagnose and repair your installation.

Frequently Asked Questions about ruflo-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my Ruflo installation is healthy?

Run npx @claude-flow/cli@latest doctor --fix to execute a full health check. It verifies Node.js, npm, git, config validity, daemon status, memory database, API keys, MCP servers, disk space, and TypeScript, then repairs issues automatically.

How do I fix a broken Ruflo daemon?

Restart the daemon with npx @claude-flow/cli@latest daemon start. The doctor command detects daemon failures during its health check and can apply this fix when run with the --fix flag.

What Node.js version does Ruflo require?

Ruflo requires Node.js 20 or higher and npm 9 or higher. The doctor health check validates both versions and reports if your environment falls below these minimums.

How do I reset a corrupted Ruflo configuration?

Run npx @claude-flow/cli@latest config reset to restore the configuration to defaults. For memory database issues, use npx @claude-flow/cli@latest memory init --force to reinitialize it.

Why does the Ruflo doctor command fail to run?

The command requires npx and network access to fetch @claude-flow/cli@latest. Failures typically stem from missing Node.js, blocked npm registry access, or insufficient permissions to execute the CLI.