ruflo — Agent Guide

No conflict-matrix pairs for this tool yet.

# Ruflo — Agent Guide

name: ruflo ｜ version_range: 3.38.20~3.38.20 ｜ generated: 2026-08-27

title_en: Ruflo - Agent Meta-Harness ｜ desc_en: Adds orchestration, memory and swarm capabilities to Claude Code / Codex.

Preflight

note: Requires Node >= 20. First install downloads native deps (~5 min, 1.6GB npx cache).

node --version

预期输出: see command output

Install

note: Method A (full CLI, npx ruflo init) verified in this environment; Method B (Claude Code plugin lite) not tested — not logged in.

Method A: Full CLI

note: Use the npmmirror branch in mainland China; drop the npm_config_registry prefix when direct connection works. Flags --no-signup/--no-skills-sh/--no-codex-detect remove interactivity and external registration.

npm_config_registry=https://registry.npmmirror.com npx -y ruflo init --no-signup --no-skills-sh --no-codex-detect
npx -y ruflo --version

预期输出: ruflo v3.38.20

Method B: Claude Code plugin (lite)

note: Official form; not tested in this environment — not logged in.

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo

预期输出: ruflo-core appears in the plugin list

Operations

View command list

npx -y ruflo --help

预期输出: starts with Ruflo v3.38.20, includes init/start/agent/swarm/memory/mcp/hooks/daemon and 30+ commands

Health diagnosis

note: Verified in this environment; starts a background daemon — run ruflo daemon stop afterwards.

npx -y ruflo doctor

预期输出: RuFlo Doctor check items (version/Node/npm/Git/config/Memory DB/MCP); ⚠ items are warnings, non-blocking; run ruflo daemon stop afterwards

Stop the background daemon

npx -y ruflo daemon stop

预期输出: Worker daemon stopped

Check swarm status

note: verified 2026-08-30 with local ollama provider (zero key); "no data"/0 columns are normal before tasks run

npx -y ruflo swarm status

预期输出: status table (Performance Metrics: Elapsed Time 0s / Success Rate no data; Coordination: Messages Sent 0 / Consensus Rounds 0)

Stop a swarm

note: verified: bare `swarm stop` fails with `[ERROR] Swarm ID is required`; get the ID from swarm status or init output

npx -y ruflo swarm stop <Swarm ID>

预期输出: swarm stop confirmation

Orchestrate a minimal scenario

note: Local ollama provider verified 2026-08-30 (zero key): configure endpoint + test PASS + swarm init/start/status orchestration layer OK; execution layer needs Claude Code / claude -p (not verified).

npx -y ruflo start

预期输出: orchestration system start status (swarm/agents/memory ready)

Uninstall

note: npm package uninstall auto-runs (idempotent); workspace-dedicated files (.claude-flow/ .swarm/ ruvector.db) also deleted when run from the ruflo-initialized directory; common-name files need manual confirmation.

npm rm -g ruflo || true
rm -rf -- .claude-flow .swarm ruvector.db 2>/dev/null || true
command -v ruflo >/dev/null 2>&1 && echo "ruflo 仍存在" || echo "ruflo removed: OK"

预期输出: ruflo removed: OK

Facts

writes: workspace .claude/, .claude-flow/, .agents/, .swarm/, .mcp.json, CLAUDE.md, ruvector.db; HOME ~/.claude/CLAUDE.md, ~/.claude-flow/ ｜ runtime: Node >= 20, npm/npx ｜ notes: background ruflo daemon (doctor/start); swarm orchestration layer verified with local ollama provider (2026-08-30, zero key); execution layer needs Claude Code / claude -p (not verified); possible-conflict with omc Claude plugin form (shared .claude/ + ~/.claude/CLAUDE.md, not tested)

Source: ruflo · validated 2026-08-27 · v3.38.20~3.38.20

← Agent index