Summary
Claude Flow (RuFlo v3.5) is an enterprise AI orchestration platform that enables deployment and coordination of 16 specialized agent roles working in swarms with self-learning and fault-tolerant consensus capabilities. The server provides tools for multi-agent orchestration, policy engines, embeddings, and proof systems powered by Rust-based WASM kernels, solving the problem of coordinating complex AI-driven software engineering tasks across distributed teams. It integrates with Claude Code and offers enterprise-grade security features alongside self-optimizing agent capabilities.
Install to Claude Code
verifiedclaude mcp add claude-flow --env ANTHROPIC_API_KEY=YOUR_ANTHROPIC_API_KEY --env CLAUDE_FLOW_MODE=YOUR_CLAUDE_FLOW_MODE --env CLAUDE_FLOW_MEMORY_PATH=YOUR_CLAUDE_FLOW_MEMORY_PATH --env CLAUDE_FLOW_MAX_AGENTS=YOUR_CLAUDE_FLOW_MAX_AGENTS --env CLAUDE_FLOW_PORT=YOUR_CLAUDE_FLOW_PORT --env GITHUB_TOKEN=YOUR_GITHUB_TOKEN --env FLOW_NEXUS_API_KEY=YOUR_FLOW_NEXUS_API_KEY -- npx -y claude-flowRun in your terminal. Replace YOUR_* placeholders with real values; add --scope user to install for every project.
Review the command, arguments, and environment values before installing — MCP servers run with your local permissions.
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Tools
Verified live against the running server on Jun 10, 2026.
verified live80 tools
agent_spawnSpawn a Ruflo-tracked agent with cost attribution + memory persistence + swarm coordination. Use when native Task tool is wrong because you need (a) cost tracking per agent in the cost-tracking namespace, (b) cross-session learning via the patterns namespace, or (c) coordinati...7 params
Spawn a Ruflo-tracked agent with cost attribution + memory persistence + swarm coordination. Use when native Task tool is wrong because you need (a) cost tracking per agent in the cost-tracking namespace, (b) cross-session learning via the patterns namespace, or (c) coordinati...
Parameters* required
taskstringTask description for intelligent model routing
modelstringClaude model alias (haiku=fast/cheap, sonnet=balanced, opus=current Opus 4.8, opus-4.7=prior Opus pin)one of
haiku · sonnet · opus · opus-4.7 · inheritconfigobjectAgent configuration
domainstringAgent domain
agentIdstringOptional custom agent ID
swarmIdstringOptional swarm to register the agent with (defaults to most-recent swarm)
agentType*stringType of agent to spawn
agent_executeRun a task on a previously-spawned agent_spawn record via the Anthropic Messages API with that agent's configured model. Use when native Task tool is wrong because (a) you need the spawned agent's persistent config (model, instructions, cost-tracking attribution) to apply to t...5 params
Run a task on a previously-spawned agent_spawn record via the Anthropic Messages API with that agent's configured model. Use when native Task tool is wrong because (a) you need the spawned agent's persistent config (model, instructions, cost-tracking attribution) to apply to t...
Parameters* required
prompt*stringTask / prompt for the agent to execute
agentId*stringID of the spawned agent
maxTokensnumberMax output tokens (default 1024)
temperaturenumberSampling temperature 0..1 (default 0.7)
systemPromptstringOptional system prompt (overrides agent default)
agent_terminateRemove a Ruflo-tracked agent from the registry and free its swarm slot. Use when you need to (a) clean up a spawned agent so its cost-tracking row finalizes, (b) reclaim a swarm-topology slot for another agent, or (c) end a stuck agent without restarting the whole swarm. For o...2 params
Remove a Ruflo-tracked agent from the registry and free its swarm slot. Use when you need to (a) clean up a spawned agent so its cost-tracking row finalizes, (b) reclaim a swarm-topology slot for another agent, or (c) end a stuck agent without restarting the whole swarm. For o...
Parameters* required
forcebooleanForce immediate termination
agentId*stringID of agent to terminate
agent_statusRead the lifecycle state of a single tracked agent: idle/running/stopped, current taskCount, lastResult, model, health score. Use when native Task tool is wrong because you need agent-level state (status across turns, accumulated taskCount, last error, swarm coordination) rath...1 params
Read the lifecycle state of a single tracked agent: idle/running/stopped, current taskCount, lastResult, model, health score. Use when native Task tool is wrong because you need agent-level state (status across turns, accumulated taskCount, last error, swarm coordination) rath...
Parameters* required
agentId*stringID of agent
agent_listList every Ruflo-tracked agent in the registry with its type, model, status, and taskCount. Use when native Task tool is wrong because you need to see the swarm-wide agent inventory across turns (which agents exist, their roles, their cost-tracking handles) rather than spawn a...3 params
List every Ruflo-tracked agent in the registry with its type, model, status, and taskCount. Use when native Task tool is wrong because you need to see the swarm-wide agent inventory across turns (which agents exist, their roles, their cost-tracking handles) rather than spawn a...
Parameters* required
domainstringFilter by domain
statusstringFilter by status
includeTerminatedbooleanInclude terminated agents
agent_poolManage a fixed-size warm pool of pre-spawned agents to skip cold-start cost on bursty workloads. Use when native Task is wrong because (a) you have a queue of similar tasks and want to amortize spawn latency, (b) cost-tracking wants stable agentIds across requests, or (c) swar...3 params
Manage a fixed-size warm pool of pre-spawned agents to skip cold-start cost on bursty workloads. Use when native Task is wrong because (a) you have a queue of similar tasks and want to amortize spawn latency, (b) cost-tracking wants stable agentIds across requests, or (c) swar...
Parameters* required
action*stringPool actionone of
status · scale · drain · fillagentTypestringAgent type filter
targetSizenumberTarget pool size (for scale action)
agent_healthCompute an agent's rolling health score (0-1) from recent task success ratio + response-latency p50/p95 + error rate. Use when native Task tool is wrong because you're running a long-lived agent (autonomous loop / hive-mind worker / federation peer) and need to detect degradat...2 params
Compute an agent's rolling health score (0-1) from recent task success ratio + response-latency p50/p95 + error rate. Use when native Task tool is wrong because you're running a long-lived agent (autonomous loop / hive-mind worker / federation peer) and need to detect degradat...
Parameters* required
agentIdstringSpecific agent ID (optional)
thresholdnumberHealth threshold (0-1)
agent_updateMutate a tracked agent's config (model, instructions, status, health) without re-spawning. Use when native Task tool is wrong because the agent already has accumulated state (taskCount, swarm membership, cost-tracking attribution) and you only need to tweak one field — for exa...5 params
Mutate a tracked agent's config (model, instructions, status, health) without re-spawning. Use when native Task tool is wrong because the agent already has accumulated state (taskCount, swarm membership, cost-tracking attribution) and you only need to tweak one field — for exa...
Parameters* required
configobjectConfig updates
healthnumberHealth value (0-1)
statusstringNew status
agentId*stringID of agent
taskCountnumberTask count
agent_logsReturn recorded activity-log entries for a tracked agent (idle/running history, last task result). Use when native Task tool is wrong because you need the agent's log across turns (what it did, last error/result, swarm context) rather than a one-shot Task transcript. For a Tas...4 params
Return recorded activity-log entries for a tracked agent (idle/running history, last task result). Use when native Task tool is wrong because you need the agent's log across turns (what it did, last error/result, swarm context) rather than a one-shot Task transcript. For a Tas...
Parameters* required
tailnumberMax recent entries to return (default 50)
levelstringMinimum log level (currently advisory — entries are synthetic)one of
debug · info · warn · errorsincestringShow logs since, e.g. "1h" / "30m" (currently advisory)
agentId*stringID of agent
swarm_initInitialize a swarm with persistent state tracking Use when native Task tool is wrong because you need multi-agent coordination — topology (hierarchical/mesh/star), consensus (raft/byzantine/gossip/crdt/quorum), shared memory namespace, or anti-drift gates. For independent one-...4 params
Initialize a swarm with persistent state tracking Use when native Task tool is wrong because you need multi-agent coordination — topology (hierarchical/mesh/star), consensus (raft/byzantine/gossip/crdt/quorum), shared memory namespace, or anti-drift gates. For independent one-...
Parameters* required
configobjectAdditional swarm configuration
strategystringAgent strategy (specialized, balanced, adaptive)
topologystringSwarm topology type (hierarchical, mesh, hierarchical-mesh, ring, star, hybrid, adaptive)
maxAgentsnumberMaximum number of agents (1-50)
swarm_statusGet swarm status from persistent state Use when native Task tool is wrong because you need multi-agent coordination — topology (hierarchical/mesh/star), consensus (raft/byzantine/gossip/crdt/quorum), shared memory namespace, or anti-drift gates. For independent one-shot subage...1 params
Get swarm status from persistent state Use when native Task tool is wrong because you need multi-agent coordination — topology (hierarchical/mesh/star), consensus (raft/byzantine/gossip/crdt/quorum), shared memory namespace, or anti-drift gates. For independent one-shot subage...
Parameters* required
swarmIdstringSwarm ID (omit for most recent)
swarm_shutdownShutdown a swarm and update persistent state Use when native Task tool is wrong because you need multi-agent coordination — topology (hierarchical/mesh/star), consensus (raft/byzantine/gossip/crdt/quorum), shared memory namespace, or anti-drift gates. For independent one-shot...2 params
Shutdown a swarm and update persistent state Use when native Task tool is wrong because you need multi-agent coordination — topology (hierarchical/mesh/star), consensus (raft/byzantine/gossip/crdt/quorum), shared memory namespace, or anti-drift gates. For independent one-shot...
Parameters* required
swarmIdstringSwarm ID to shutdown
gracefulbooleanGraceful shutdown (default: true)
swarm_healthCheck swarm health status with real state inspection Use when native Task tool is wrong because you need multi-agent coordination — topology (hierarchical/mesh/star), consensus (raft/byzantine/gossip/crdt/quorum), shared memory namespace, or anti-drift gates. For independent o...1 params
Check swarm health status with real state inspection Use when native Task tool is wrong because you need multi-agent coordination — topology (hierarchical/mesh/star), consensus (raft/byzantine/gossip/crdt/quorum), shared memory namespace, or anti-drift gates. For independent o...
Parameters* required
swarmIdstringSwarm ID to check
memory_storePersistent key-value store with vector embedding — survives across sessions and is searchable by meaning, not just by file path. Use when native Write is wrong because the data is not a file (e.g. a learned pattern, a decision, a budget config) AND you need to recall it later...6 params
Persistent key-value store with vector embedding — survives across sessions and is searchable by meaning, not just by file path. Use when native Write is wrong because the data is not a file (e.g. a learned pattern, a decision, a budget config) AND you need to recall it later...
Parameters* required
key*stringMemory key (unique within namespace)
ttlnumberTime-to-live in seconds (optional)
tagsarrayOptional tags for filtering
value*valueValue to store (string or object)
upsertbooleanIf true, update existing key instead of failing (default: false)
namespacestringNamespace for organization (default: "default")
memory_retrieveRead back a value previously stored via memory_store, by exact (namespace, key) — lossless, includes metadata. Use when native Read is wrong because the value is not a file (it lives in the .swarm/memory.db SQLite store) AND you know the exact key. For semantic lookup by meani...2 params
Read back a value previously stored via memory_store, by exact (namespace, key) — lossless, includes metadata. Use when native Read is wrong because the value is not a file (it lives in the .swarm/memory.db SQLite store) AND you know the exact key. For semantic lookup by meani...
Parameters* required
key*stringMemory key
namespacestringNamespace (default: "default")
memory_searchFind stored memories by meaning (vector similarity), not by literal text — finds "JWT auth pattern" when you query "token-based login flow". Use when native Grep is wrong because Grep matches characters and you need to find conceptually-related entries across past sessions. Ba...5 params
Find stored memories by meaning (vector similarity), not by literal text — finds "JWT auth pattern" when you query "token-based login flow". Use when native Grep is wrong because Grep matches characters and you need to find conceptually-related entries across past sessions. Ba...
Parameters* required
limitnumberMaximum results (default: 10)
query*stringSearch query (semantic similarity)
smartbooleanEnable SmartRetrieval pipeline — query expansion, RRF fusion, recency boost, MMR diversity (default: false)
namespacestringNamespace to search (default: "default")
thresholdnumberMinimum similarity threshold 0-1 (default: 0.3)
memory_deleteRemove a stored memory entry by exact (namespace, key). Use when a previously stored decision is invalidated or contains stale data. No native equivalent — Write to a file does not affect the .swarm/memory.db SQLite store.2 params
Remove a stored memory entry by exact (namespace, key). Use when a previously stored decision is invalidated or contains stale data. No native equivalent — Write to a file does not affect the .swarm/memory.db SQLite store.
Parameters* required
key*stringMemory key
namespacestringNamespace (default: "default")
memory_listEnumerate stored memory entries (optionally filtered by namespace/tags) without semantic search. Use when native Glob is wrong because the entries are not files (they live in .swarm/memory.db). For inspection / audit / "what is in my memory" — pair with memory_search for retri...3 params
Enumerate stored memory entries (optionally filtered by namespace/tags) without semantic search. Use when native Glob is wrong because the entries are not files (they live in .swarm/memory.db). For inspection / audit / "what is in my memory" — pair with memory_search for retri...
Parameters* required
limitnumberMaximum results (default: 50)
offsetnumberOffset for pagination (default: 0)
namespacestringFilter by namespace
memory_statsGet memory storage statistics including HNSW index status Use when native Read/Write is wrong because you need (a) cross-session retrieval by semantic similarity (vector embeddings) not by file path, (b) namespacing across projects without managing directory layout, or (c) the...
Get memory storage statistics including HNSW index status Use when native Read/Write is wrong because you need (a) cross-session retrieval by semantic similarity (vector embeddings) not by file path, (b) namespacing across projects without managing directory layout, or (c) the...
No parameters — call it with no arguments.
memory_migrateManually trigger migration from legacy JSON store to sql.js Use when native Read/Write is wrong because you need (a) cross-session retrieval by semantic similarity (vector embeddings) not by file path, (b) namespacing across projects without managing directory layout, or (c) t...1 params
Manually trigger migration from legacy JSON store to sql.js Use when native Read/Write is wrong because you need (a) cross-session retrieval by semantic similarity (vector embeddings) not by file path, (b) namespacing across projects without managing directory layout, or (c) t...
Parameters* required
forcebooleanForce re-migration even if already done
memory_import_claudeImport Claude Code auto-memory files into AgentDB with ONNX vector embeddings. Reads ~/.claude/projects/*/memory/*.md files, parses YAML frontmatter, splits into sections, and stores with 384-dim embeddings for semantic search. Use allProjects=true to import from ALL Claude pr...5 params
Import Claude Code auto-memory files into AgentDB with ONNX vector embeddings. Reads ~/.claude/projects/*/memory/*.md files, parses YAML frontmatter, splits into sections, and stores with 384-dim embeddings for semantic search. Use allProjects=true to import from ALL Claude pr...
Parameters* required
namespacestringTarget namespace (default: "claude-memories")
allProjectsbooleanImport from all Claude projects (default: current project only)
projectPathstring#1883 — explicit project path to hash, used when cwd does not match Claude Code's view (e.g. WSL bridge to Windows host). Pass the canonical project root as Claude Code sees it.
excludeFilesarray#1937 — absolute file paths to skip verbatim. Faster than a pattern when the list is known ahead of time (operator captured baselines). Combine with excludeFilePatterns.
excludeFilePatternsarray#1937 — glob patterns matched against the absolute file path. Files matching ANY pattern are skipped. Supports `*` (any chars within a path segment), `**` (any chars including separators), and `?` (single char). Examples: `**/voice-*.md`, `**/persona-*.md`. Combine with excludeFiles for explicit paths.
memory_bridge_statusShow Claude Code memory bridge status — AgentDB vectors, SONA learning, intelligence patterns, and connection health. Use when native Read/Write is wrong because you need (a) cross-session retrieval by semantic similarity (vector embeddings) not by file path, (b) namespacing a...
Show Claude Code memory bridge status — AgentDB vectors, SONA learning, intelligence patterns, and connection health. Use when native Read/Write is wrong because you need (a) cross-session retrieval by semantic similarity (vector embeddings) not by file path, (b) namespacing a...
No parameters — call it with no arguments.
memory_search_unifiedSearch across both Claude Code memories and AgentDB entries using semantic vector similarity. Returns merged, deduplicated results from all namespaces. Use when native Read/Write is wrong because you need (a) cross-session retrieval by semantic similarity (vector embeddings) n...4 params
Search across both Claude Code memories and AgentDB entries using semantic vector similarity. Returns merged, deduplicated results from all namespaces. Use when native Read/Write is wrong because you need (a) cross-session retrieval by semantic similarity (vector embeddings) n...
Parameters* required
limitnumberMax results (default: 10)
query*stringSearch query (natural language)
namespacestringFilter to a single namespace (mutually exclusive with `namespaces`)
namespacesarrayExplicit list of namespaces to fan out across (overrides defaults and env)
memory_detailed-statsDetailed memory-store report — backend, entry count, total bytes, per-namespace counts, and (placeholder) perf metrics. Use when native Read/Glob is wrong because the data lives in .swarm/memory.db, not files, and you want an aggregate health view. For a quick count use memory...
Detailed memory-store report — backend, entry count, total bytes, per-namespace counts, and (placeholder) perf metrics. Use when native Read/Glob is wrong because the data lives in .swarm/memory.db, not files, and you want an aggregate health view. For a quick count use memory...
No parameters — call it with no arguments.
memory_cleanupPrune memory entries whose TTL has expired (dry run by default; pass dryRun:false to delete). Use when native rm is wrong because the entries are rows in .swarm/memory.db, not files. For removing a specific known key use memory_delete. Stale/low-quality pruning is delegated to...2 params
Prune memory entries whose TTL has expired (dry run by default; pass dryRun:false to delete). Use when native rm is wrong because the entries are rows in .swarm/memory.db, not files. For removing a specific known key use memory_delete. Stale/low-quality pruning is delegated to...
Parameters* required
dryRunbooleanOnly report candidates, do not delete (default true)
namespacestringLimit cleanup to one namespace
memory_compressReport memory-store size breakdown (the sql.js backend has no on-disk compression — entries are already stored compactly; quantized embeddings via RaBitQ are configured elsewhere). Use when native du is wrong because the data is in .swarm/memory.db. For pruning expired entries...
Report memory-store size breakdown (the sql.js backend has no on-disk compression — entries are already stored compactly; quantized embeddings via RaBitQ are configured elsewhere). Use when native du is wrong because the data is in .swarm/memory.db. For pruning expired entries...
No parameters — call it with no arguments.
memory_exportExport memory entries to a JSON file (keys, namespaces, timestamps, and values when available). Use when native Write is wrong because the data is rows in .swarm/memory.db, not a file you can copy. For ingesting an export elsewhere use memory_import. (CSV output and embedding-...4 params
Export memory entries to a JSON file (keys, namespaces, timestamps, and values when available). Use when native Write is wrong because the data is rows in .swarm/memory.db, not a file you can copy. For ingesting an export elsewhere use memory_import. (CSV output and embedding-...
Parameters* required
formatstringExport format (csv falls back to json today)one of
json · csvnamespacestringLimit export to one namespace
outputPath*stringFile path to write the JSON export to
includeVectorsbooleanInclude embedding vectors (advisory — not exported yet)
memory_importImport memory entries from a JSON export file (produced by memory_export) into .swarm/memory.db, re-embedding values. Use when native Read is wrong because the data must be re-stored as memory rows (with new embeddings), not just read. For importing Claude Code's own memory fi...3 params
Import memory entries from a JSON export file (produced by memory_export) into .swarm/memory.db, re-embedding values. Use when native Read is wrong because the data must be re-stored as memory rows (with new embeddings), not just read. For importing Claude Code's own memory fi...
Parameters* required
mergebooleanMerge into existing entries (upsert) vs. fail on conflict (default true)
inputPath*stringPath to the JSON export file
namespacestringOverride the namespace for all imported entries
config_getGet configuration value Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files, na...2 params
Get configuration value Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files, na...
Parameters* required
key*stringConfiguration key (dot notation supported)
scopestringConfiguration scope (project, user, system)
config_setSet configuration value Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files, na...3 params
Set configuration value Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files, na...
Parameters* required
key*stringConfiguration key (dot notation supported)
scopestringConfiguration scope (project, user, system)
value*valueConfiguration value
config_listList configuration values Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files,...3 params
List configuration values Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files,...
Parameters* required
scopestringConfiguration scope
prefixstringKey prefix filter
includeDefaultsbooleanInclude default values
config_resetReset configuration to defaults Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style f...2 params
Reset configuration to defaults Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style f...
Parameters* required
keystringSpecific key to reset (omit to reset all)
scopestringConfiguration scope
config_exportExport configuration to JSON Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style file...2 params
Export configuration to JSON Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style file...
Parameters* required
scopestringConfiguration scope
includeDefaultsbooleanInclude default values
config_importImport configuration from JSON Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style fi...3 params
Import configuration from JSON Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style fi...
Parameters* required
mergebooleanMerge with existing (true) or replace (false)
scopestringConfiguration scope
config*objectConfiguration object to import
hooks_intelligence_unified-statsOne honest view across the four learning stat sources: globalStats (`.claude-flow/neural/stats.json`), the in-memory SONA coordinator, memory-bridge AgentDB entries, and the neural-patterns store. Each sub-view names its source path. The `consistency` block notes cross-store d...1 params
One honest view across the four learning stat sources: globalStats (`.claude-flow/neural/stats.json`), the in-memory SONA coordinator, memory-bridge AgentDB entries, and the neural-patterns store. Each sub-view names its source path. The `consistency` block notes cross-store d...
Parameters* required
verbosebooleanInclude extended breakdownsdefault: true
hooks_teammate-idleAgent Teams hook — fired when a teammate agent finishes its turn; reports whether a pending task can be auto-assigned. Use when native Task is wrong because you have a persistent multi-agent team with a shared task list and want idle workers picked up automatically rather than...5 params
Agent Teams hook — fired when a teammate agent finishes its turn; reports whether a pending task can be auto-assigned. Use when native Task is wrong because you have a persistent multi-agent team with a shared task list and want idle workers picked up automatically rather than...
Parameters* required
teamNamestringTeam name
timestampnumberEvent timestamp (ms)
autoAssignbooleanAuto-assign a pending task if available
teammateIdstringID of the idle teammate
checkTaskListbooleanConsult the shared task list
hooks_task-completedAgent Teams hook — fired when a task is marked complete. Records the completion and, when `trainPatterns:true`, feeds the outcome to the SONA + EWC++ learning pipeline (the same path used by hooks_intelligence trajectory-*). Multiple ways to drive learning exist: (a) call this...7 params
Agent Teams hook — fired when a task is marked complete. Records the completion and, when `trainPatterns:true`, feeds the outcome to the SONA + EWC++ learning pipeline (the same path used by hooks_intelligence trajectory-*). Multiple ways to drive learning exist: (a) call this...
Parameters* required
taskId*stringID of the completed task
contentstringOptional richer task description; used as the trajectory step content when training. Defaults to the taskId.
qualitynumberQuality score 0-1
successbooleanWhether the task succeeded
notifyLeadbooleanNotify the team lead
teammateIdstringTeammate that completed it
trainPatternsbooleanWhen true, runs the SONA + EWC++ trajectory pipeline on this completion so globalStats.patternsLearned reflects it. When false (default), only records the completion.
hooks_pre-editGet context and agent suggestions before editing a file Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shel...3 params
Get context and agent suggestions before editing a file Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shel...
Parameters* required
contextstringAdditional context
filePath*stringPath to the file being edited
operationstringType of operation (create, update, delete, refactor)
hooks_post-editRecord editing outcome for learning Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Ba...3 params
Record editing outcome for learning Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Ba...
Parameters* required
agentstringAgent that performed the edit
successbooleanWhether the edit was successful
filePath*stringPath to the edited file
hooks_pre-commandAssess risk before executing a command Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain...1 params
Assess risk before executing a command Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain...
Parameters* required
command*stringCommand to execute
hooks_post-commandRecord command execution outcome Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash...2 params
Record command execution outcome Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash...
Parameters* required
command*stringExecuted command
exitCodenumberCommand exit code
hooks_routeGet a 3-tier routing recommendation for a task: Tier 1 (deterministic codemod, ~0ms / $0 — for var-to-const, remove-console, add-logging), Tier 2 (Haiku — simple), Tier 3 (Sonnet/Opus — complex). Use this BEFORE spawning an agent to avoid sending simple transforms to Sonnet. N...3 params
Get a 3-tier routing recommendation for a task: Tier 1 (deterministic codemod, ~0ms / $0 — for var-to-const, remove-console, add-logging), Tier 2 (Haiku — simple), Tier 3 (Sonnet/Opus — complex). Use this BEFORE spawning an agent to avoid sending simple transforms to Sonnet. N...
Parameters* required
task*stringTask description
contextstringAdditional context
useSemanticRouterbooleanUse semantic similarity routing (default: true)
hooks_metricsView learning metrics dashboard Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash h...2 params
View learning metrics dashboard Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash h...
Parameters* required
periodstringMetrics period (1h, 24h, 7d, 30d)
includeV3booleanInclude V3 performance metrics
hooks_listList all registered hooks Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash hooks a...
List all registered hooks Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash hooks a...
No parameters — call it with no arguments.
hooks_pre-taskRecord task start and get agent suggestions with intelligent model routing (ADR-026) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking,...3 params
Record task start and get agent suggestions with intelligent model routing (ADR-026) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking,...
Parameters* required
taskId*stringTask identifier
filePathstringOptional file path for AST analysis
description*stringTask description
hooks_post-taskRecord task completion for learning Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Ba...8 params
Record task completion for learning Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Ba...
Parameters* required
taskstringTask description text (used for learning keyword extraction)
agentstringAgent that completed the task
depthnumberChain depth from root lead session (0 = lead, 1+ = subagent). Used by ADR-147 P3 depth-aware guardrail.
taskId*stringTask identifier
qualitynumberQuality score (0-1)
successbooleanWhether task was successful
parentAgentIdstringID of the parent agent (from Claude Code's parent_agent_id OTel span tag / x-claude-code-parent-agent-id header). Omit for top-level work.
storeDecisionsbooleanAlso store routing decision in memory DB
hooks_explainExplain routing decision with full transparency Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell comman...3 params
Explain routing decision with full transparency Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell comman...
Parameters* required
task*stringTask description
agentstringSpecific agent to explain
verbosebooleanVerbose explanation
hooks_pretrainAnalyze repository to bootstrap intelligence (4-step pipeline) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-o...3 params
Analyze repository to bootstrap intelligence (4-step pipeline) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-o...
Parameters* required
pathstringRepository path
depthstringAnalysis depth (shallow, medium, deep)
skipCachebooleanSkip cached analysis
hooks_build-agentsGenerate optimized agent configurations from pretrain data Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off s...4 params
Generate optimized agent configurations from pretrain data Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off s...
Parameters* required
focusstringFocus area (v3-implementation, security, performance, all)
formatstringConfig format (yaml, json)
persistbooleanWrite configs to disk
outputDirstringOutput directory for configs
hooks_transferTransfer learned patterns from another project Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell command...3 params
Transfer learned patterns from another project Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell command...
Parameters* required
filterstringFilter patterns by type
sourcePath*stringSource project path
minConfidencenumberMinimum confidence threshold
hooks_session-startInitialize a new session and auto-start daemon Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell command...3 params
Initialize a new session and auto-start daemon Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell command...
Parameters* required
sessionIdstringOptional session ID
startDaemonbooleanStart worker daemon (default: false — opt-in to prevent unintended token usage)
restoreLatestbooleanRestore latest session state
hooks_session-endEnd current session, stop daemon, and persist state Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell co...3 params
End current session, stop daemon, and persist state Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell co...
Parameters* required
saveStatebooleanSave session state
stopDaemonbooleanStop worker daemon (default: true)
exportMetricsbooleanExport session metrics
hooks_session-restoreRestore a previous session Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash hooks...3 params
Restore a previous session Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash hooks...
Parameters* required
sessionIdstringSession ID to restore (or "latest")
restoreTasksbooleanRestore active tasks
restoreAgentsbooleanRestore spawned agents
hooks_notifySend cross-agent notification Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash hoo...4 params
Send cross-agent notification Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash hoo...
Parameters* required
dataobjectAdditional data payload
targetstringTarget agent or "all"
message*stringNotification message
prioritystringPriority level (low, normal, high, urgent)
hooks_initInitialize hooks in project with .claude/settings.json Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell...3 params
Initialize hooks in project with .claude/settings.json Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell...
Parameters* required
pathstringProject path
forcebooleanOverwrite existing configuration
templatestringTemplate to use (minimal, standard, full)
hooks_intelligenceRuVector intelligence system status (shows REAL metrics from memory store) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chai...6 params
RuVector intelligence system status (shows REAL metrics from memory store) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chai...
Parameters* required
modestringIntelligence mode
enableMoebooleanEnable MoE routing
enableHnswbooleanEnable HNSW search
enableSonabooleanEnable SONA learning
showStatusbooleanShow status only
forceTrainingbooleanForce training cycle
hooks_intelligence-resetReset intelligence learning state Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash...
Reset intelligence learning state Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash...
No parameters — call it with no arguments.
hooks_intelligence_trajectory-startBegin SONA trajectory for reinforcement learning Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell comma...2 params
Begin SONA trajectory for reinforcement learning Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell comma...
Parameters* required
task*stringTask description
agentstringAgent type
hooks_intelligence_trajectory-stepRecord step in trajectory for reinforcement learning Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell c...4 params
Record step in trajectory for reinforcement learning Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell c...
Parameters* required
action*stringAction taken
resultstringAction result
qualitynumberQuality score (0-1)
trajectoryId*stringTrajectory ID
hooks_intelligence_trajectory-endEnd trajectory and trigger SONA learning with EWC++ Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell co...3 params
End trajectory and trigger SONA learning with EWC++ Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell co...
Parameters* required
successbooleanOverall success
feedbackstringOptional feedback
trajectoryId*stringTrajectory ID
hooks_intelligence_pattern-storeStore pattern in ReasoningBank (HNSW-indexed) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands...4 params
Store pattern in ReasoningBank (HNSW-indexed) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands...
Parameters* required
typestringPattern type
pattern*stringPattern description
metadataobjectAdditional metadata
confidencenumberConfidence score
hooks_intelligence_pattern-searchSearch patterns using REAL vector search (HNSW when available, brute-force fallback) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking,...4 params
Search patterns using REAL vector search (HNSW when available, brute-force fallback) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking,...
Parameters* required
topKnumberNumber of results
query*stringSearch query
namespacestringNamespace to search (default: pattern)
minConfidencenumberMinimum similarity threshold (0-1)
hooks_intelligence_statsGet RuVector intelligence layer statistics Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, p...1 params
Get RuVector intelligence layer statistics Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, p...
Parameters* required
detailedbooleanInclude detailed stats
hooks_intelligence_learnForce immediate SONA learning cycle with EWC++ consolidation Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off...2 params
Force immediate SONA learning cycle with EWC++ consolidation Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off...
Parameters* required
consolidatebooleanRun EWC++ consolidation
trajectoryIdsarraySpecific trajectories to learn from
hooks_intelligence_attentionCompute attention-weighted similarity using MoE/Flash/Hyperbolic Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one...3 params
Compute attention-weighted similarity using MoE/Flash/Hyperbolic Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one...
Parameters* required
modestringAttention mode (flash, moe, hyperbolic)
topKnumberTop-k results
query*stringQuery for attention computation
hooks_worker-listList all 12 background workers with status and capabilities Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off...2 params
List all 12 background workers with status and capabilities Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off...
Parameters* required
statusstringFilter by status (all, running, completed, pending)
includeActivebooleanInclude active worker instances
hooks_worker-dispatchDispatch a background worker for analysis/optimization tasks Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off...4 params
Dispatch a background worker for analysis/optimization tasks Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off...
Parameters* required
contextstringContext for the worker (file path, topic, etc.)
trigger*stringWorker trigger typeone of
ultralearn · optimize · consolidate · predict · audit · mapprioritystringPriority (low, normal, high, critical)
backgroundbooleanRun in background (non-blocking)
hooks_worker-statusGet status of a specific worker or all active workers Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell...2 params
Get status of a specific worker or all active workers Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell...
Parameters* required
workerIdstringSpecific worker ID to check
includeCompletedbooleanInclude completed workers
hooks_worker-detectDetect worker triggers from user prompt (for UserPromptSubmit hook) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For...3 params
Detect worker triggers from user prompt (for UserPromptSubmit hook) Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For...
Parameters* required
prompt*stringUser prompt to analyze
autoDispatchbooleanAutomatically dispatch detected workers
minConfidencenumberMinimum confidence threshold (0-1)
hooks_worker-cancelCancel a running worker Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash hooks are...1 params
Cancel a running worker Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash hooks are...
Parameters* required
workerId*stringWorker ID to cancel
hooks_model-routeRoute task to optimal Claude model (haiku/sonnet/opus) based on complexity Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chai...3 params
Route task to optimal Claude model (haiku/sonnet/opus) based on complexity Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chai...
Parameters* required
task*stringTask description to analyze
preferCostbooleanPrefer cheaper models when possible
preferSpeedbooleanPrefer faster models when possible
hooks_model-outcomeRecord model routing outcome for learning Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, pl...3 params
Record model routing outcome for learning Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, pl...
Parameters* required
task*stringOriginal task
model*stringModel usedone of
haiku · sonnet · opusoutcome*stringTask outcomeone of
success · failure · escalatedhooks_model-statsGet model routing statistics Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash hook...
Get model routing statistics Use when native Bash hooks (via Claude Code's settings.json) are wrong because you need Ruflo-side state — pattern persistence, neural training signals, model-routing learning, cost tracking, audit chain. For one-off shell commands, plain Bash hook...
No parameters — call it with no arguments.
hooks_codemodApply a deterministic, $0 (no-LLM) code transform — the real Tier-1 execution path (ADR-143). Supported intents: var-to-const, remove-console, add-logging. Uses the TypeScript compiler with formatting-preserving edits (comments/whitespace survive). Targets: raw `code` (returns...7 params
Apply a deterministic, $0 (no-LLM) code transform — the real Tier-1 execution path (ADR-143). Supported intents: var-to-const, remove-console, add-logging. Uses the TypeScript compiler with formatting-preserving edits (comments/whitespace survive). Targets: raw `code` (returns...
Parameters* required
codestringRaw source to transform instead of files (returns transformed code, writes nothing)
filestringPath to a single existing source file to transform in place
globstringGlob pattern (relative to project root, e.g. "src/**/*.ts") — applies the intent to every matching source file
filesarrayMultiple file paths to transform in one batch call
dryRunbooleanReport what would change without writing files
intent*stringDeterministic codemod to applyone of
var-to-const · remove-console · add-logginglanguagestringLanguage hint for raw code (default typescript; inferred from extension for files)one of
javascript · typescript · jsx · tsxtask_createCreate a new task Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.5 params
Create a new task Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.
Parameters* required
tagsarrayTask tags
type*stringTask type (feature, bugfix, research, refactor)
assignToarrayAgent IDs to assign
prioritystringTask priority (low, normal, high, critical)
description*stringTask description
task_statusGet task status Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.1 params
Get task status Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.
Parameters* required
taskId*stringTask ID
task_listList all tasks Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.5 params
List all tasks Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.
Parameters* required
typestringFilter by type
limitnumberMax tasks to return
statusstringFilter by status
prioritystringFilter by priority
assignedTostringFilter by assigned agent
task_completeMark task as complete Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.2 params
Mark task as complete Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.
Parameters* required
resultobjectTask result data
taskId*stringTask ID
task_updateUpdate task status or progress Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.4 params
Update task status or progress Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.
Parameters* required
statusstringNew status
taskId*stringTask ID
assignToarrayAgent IDs to assign
progressnumberProgress percentage (0-100)
task_assignAssign a task to one or more agents Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.3 params
Assign a task to one or more agents Use when native TodoWrite is wrong because you need cross-session task persistence, agent assignment, dependency tracking, or completion analytics in the .swarm/memory.db. For in-session checklists native TodoWrite is simpler and faster.
Parameters* required
taskId*stringTask ID to assign
agentIdsarrayAgent IDs to assign
unassignbooleanUnassign all agents from task
Ruflo
Multi-agent AI harness for Claude Code and Codex
Orchestrate 100+ specialized AI agents across machines, teams, and trust boundaries. Ruflo adds coordinated swarms, self-learning memory, federated comms, and enterprise security to Claude Code — so agents don't just run, they collaborate.
Why Ruflo?
Claude Flow is now Ruflo — named by
rUv, who loves Rust, flow states, and building things that feel inevitable. The "Ru" is the rUv. The "flo" is working until 3am. Underneath, powered byCognitum.Oneagentic architecture, running a supercharged Rust based AI engine, embeddings, memory, and plugin system.
What Ruflo Does
One npx ruflo init gives Claude Code a nervous system: agents self-organize into swarms, learn from every task, remember across sessions, and — with federation — securely talk to agents on other machines without leaking data. You keep writing code. Ruflo handles the coordination.
Self-Learning / Self-Optimizing Agent Architecture
User --> Ruflo (CLI/MCP) --> Router --> Swarm --> Agents --> Memory --> LLM Providers
^ |
+---- Learning Loop <-------+
New to Ruflo? You don't need to learn 314 MCP tools or 26 CLI commands. After
init, just use Claude Code normally -- the hooks system automatically routes tasks, learns from successful patterns, and coordinates agents in the background.
Quick Start
There are two different install paths with very different surface areas. Pick based on what you need (#1744):
| Claude Code Plugin | CLI install (npx ruflo init) | |
|---|---|---|
| What it gives you | Slash commands + a few skills + agent definitions per-plugin | Full Ruflo loop — 98 agents, 60+ commands, 30 skills, MCP server, hooks, daemon |
| Files in your workspace | Zero | .claude/, .claude-flow/, CLAUDE.md, helpers, settings |
| MCP server registered | No (memory_store, swarm_init, etc. unavailable to Claude) | Yes |
| Hooks installed | No | Yes |
| Best for | Try a single plugin's commands without committing to the full install | Production use — everything works as documented |
Path A — Claude Code Plugins (lite, slash commands only)
# Add the marketplace
/plugin marketplace add ruvnet/ruflo
# Install core + any plugins you need
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo
/plugin install ruflo-neural-trader@ruflo
This adds slash commands and agent definitions only. The Ruflo MCP server is NOT registered, so memory_store, swarm_init, agent_spawn, etc. won't be callable from Claude. For the full loop, use Path B below.
🔌 All 34 plugins
Core & Orchestration
| Plugin | What it does |
|---|---|
| ruflo-core | Foundation — server, health checks, plugin discovery |
| ruflo-swarm | Coordinate multiple agents as a team |
| ruflo-autopilot | Let agents run autonomously in a loop |
| ruflo-loop-workers | Schedule background tasks on a timer |
| ruflo-workflows | Reusable multi-step task templates |
| ruflo-federation | Agents on different machines collaborate securely |
Memory & Knowledge
| Plugin | What it does |
|---|---|
| ruflo-agentdb | Fast vector database for agent memory |
| ruflo-rag-memory | Smart retrieval — hybrid search, graph hops, diversity ranking |
| ruflo-rvf | Save and restore agent memory across sessions |
| ruflo-ruvector | ruvector — GPU-accelerated search, Graph RAG, 103 tools |
| ruflo-knowledge-graph | Build and traverse entity relationship maps |
Intelligence & Learning
| Plugin | What it does |
|---|---|
| ruflo-intelligence | Agents learn from past successes and get smarter |
| ruflo-graph-intelligence | Sublinear graph reasoning — PageRank, delta updates, complexity-aware execution (ADR-123) |
| ruflo-daa | Dynamic agent behavior and cognitive patterns |
| ruflo-ruvllm | Run local LLMs (Ollama, etc.) with smart routing |
| ruflo-goals | Break big goals into plans and track progress |
Code Quality & Testing
| Plugin | What it does |
|---|---|
| ruflo-testgen | Find missing tests and generate them automatically |
| ruflo-browser | Automate browser testing with Playwright |
| ruflo-jujutsu | Analyze git diffs, score risk, suggest reviewers |
| ruflo-docs | Generate and maintain documentation automatically |
Security & Compliance
| Plugin | What it does |
|---|---|
| ruflo-security-audit | Scan for vulnerabilities and CVEs |
| ruflo-aidefence | Block prompt injection, detect PII, safety scanning |
Architecture & Methodology
| Plugin | What it does |
|---|---|
| ruflo-adr | Track architecture decisions with a living record |
| ruflo-ddd | Scaffold domain-driven design — contexts, aggregates, events |
| ruflo-sparc | Guided 5-phase development methodology with quality gates |
| ruflo-metaharness | Grade your agent setup, scan tool configs for security risks, and track changes over time (guide) |
DevOps & Observability
| Plugin | What it does |
|---|---|
| ruflo-migrations | Manage database schema changes safely |
| ruflo-observability | Structured logs, traces, and metrics in one place |
| ruflo-cost-tracker | Track token usage, set budgets, get cost alerts |
Extensibility
| Plugin | What it does |
|---|---|
| ruflo-agent | Run agents — local WASM sandbox (rvagent) + Anthropic Claude Managed Agents (cloud) |
| ruflo-plugin-creator | Scaffold, validate, and publish your own plugins |
Domain-Specific
| Plugin | What it does |
|---|---|
| ruflo-iot-cognitum | IoT device management — trust scoring, anomaly detection, fleets |
| ruflo-neural-trader | neural-trader — AI trading with 4 agents, backtesting, 112+ tools |
| ruflo-market-data | Ingest market data, vectorize OHLCV, detect patterns |
CLI Install
macOS / Linux / WSL / Git-Bash:
# One-line install (POSIX shells only — see Windows note below)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
All platforms (including native Windows PowerShell / cmd):
# Interactive setup wizard — runs identically on every platform
npx ruflo@latest init wizard
# Quick non-interactive init
# npx ruflo@latest init
# Or install globally
npm install -g ruflo@latest
💡 Windows users: the
curl ... | bashform needs a POSIX shell (Git-Bash, WSL, MSYS). Thenpx ruflo@latest init wizardline works natively in PowerShell and cmd. If you hit an'bash' is not recognizederror, use thenpxline instead — both end up running the same init flow.
MCP Server
# Add Ruflo as an MCP server in Claude Code (canonical form, matches USERGUIDE.md)
claude mcp add ruflo -- npx ruflo@latest mcp start
What You Get
| Capability | Description |
|---|---|
| 🤖 100+ Agents | Specialized agents for coding, testing, security, docs, architecture |
| 📡 Comms Layer | Zero-trust federation — agents across machines/orgs discover, authenticate, and exchange work securely |
| 🐝 Swarm Coordination | Hierarchical, mesh, and adaptive topologies with consensus |
| 🧠 Self-Learning | SONA neural patterns, ReasoningBank, trajectory learning |
| 💾 Vector Memory | HNSW-indexed AgentDB — measured ~1.9x faster at N=20k, ~3.2x–4.7x at N=5k vs brute force (recall@10 ~0.99); ANN wins above the crossover, ties/loses at small N. See audit + scripts/benchmark-intelligence.mjs |
| ⚡ Background Workers | 12 auto-triggered workers (audit, optimize, testgaps, etc.) |
| 🧩 Plugin Marketplace | 33 native Claude Code plugins + 21 npm plugins |
| 🔌 Multi-Provider | Claude, GPT, Gemini, Cohere, Ollama with smart routing |
| 🛡️ Security | AIDefence, input validation, CVE remediation, path traversal prevention |
| 🌐 Agent Federation | Cross-installation agent collaboration with zero-trust security |
| 🔬 MetaHarness | Audit your AI agent setup before you ship. Grade readiness (1-100), scan tool configs for security issues, snapshot the whole project to catch regressions over time, and find templates that match your repo. ruflo eject turns a ruflo project into a standalone agent toolkit with its own name. Full guide. |
| 💬 Web UI Beta | Multi-model chat at flo.ruv.io with parallel MCP tool calling and an in-browser WASM tool gallery |
| 🎯 RuFlo Research | GOAP A* planner at goal.ruv.io — plain-English goals → executable agent plans, with a live agent dashboard at /agents |
Web UI (Beta) — self-hostable, hosted demo at flo.ruv.io
RuFlo's web UI is a multi-model AI chat with built-in Model Context Protocol (MCP) tool calling. Talk to Qwen, Claude, Gemini, or OpenAI while RuFlo invokes the same MCP tools the CLI uses — agent orchestration, persistent memory, swarm coordination, code review, GitHub ops — directly from chat. No install, no API key needed to try it.
| What it is | Why it matters | |
|---|---|---|
| 🧠 | Any model, local or remote | 6 curated frontier models out-of-the-box — Qwen 3.6 Max (default), Claude Sonnet 4.6, Claude Haiku 4.5, Gemini 2.5 Pro, Gemini 2.5 Flash, OpenAI — via OpenRouter. Add your own: any OpenAI-compatible endpoint (vLLM, Ollama, LM Studio, Together, Groq, self-hosted). |
| 🦾 | ruvLLM self-learning AI | Native support for ruvLLM (lives in ruvnet/RuVector/examples/ruvLLM) — RuFlo's self-improving local model layer. Routes to MicroLoRA adapters, learns from your trajectories via SONA, and stays on your machine. Pair with the cloud models or run fully offline. |
| 🛠️ | ~210 tools, ready to call | 5 server groups (Core, Intelligence, Agents, Memory, DevTools) plus an 18-tool gallery that runs entirely in your browser — works offline. |
| 🔌 | Bring your own MCP servers | Click the MCP (n) pill in the chat input → Add Server and paste any MCP endpoint (HTTP, SSE, or stdio). Your tools join RuFlo's native ones in the same parallel-execution flow. Run a local MCP server on localhost:3000 and it just works. |
| ⚡ | Tools run in parallel | One model response can fire 4–6+ tools at the same time. The UI shows them as cards with a Step 1 — 2 tools completed badge so you can see exactly what ran. |
| 💾 | Memory that sticks | Say "remember my favorite color is indigo" and ask weeks later — RuFlo recalls it. Backed by AgentDB + HNSW vector search (measured ~1.9x–4.7x faster than brute force above the crossover, recall@10 ~0.99). |
| 📘 | Built-in capabilities tour | Click the question-mark icon in the sidebar — a "RuFlo Capabilities" modal opens with the full tool list, model strengths, architecture, and keyboard shortcuts. |
| 🏠 | Self-hostable | Web UI is shipped as Docker (ruflo/src/ruvocal/Dockerfile) with embedded Mongo. Deploy to your own Cloud Run / Fly / Kubernetes / docker-compose. The hosted flo.ruv.io demo is one option; running your own is fully supported. |
| 🚀 | Zero install to try | Open the hosted URL, pick a model, type a question. That's the whole onboarding. |
Try the hosted demo: https://flo.ruv.io/ — no account, no API key. Run your own: the source lives in ruflo/src/ruvocal/ with a multi-stage Dockerfile (INCLUDE_DB=true builds in MongoDB) and a cloudbuild.yaml for Google Cloud Run. See ADR-033 for the architecture and issue #1689 for the roadmap.
Goal Planner UI — autonomous agents at goal.ruv.io
Turn high-level goals into executable agent plans. goal.ruv.io is RuFlo's hosted Goal-Oriented Action Planning (GOAP) front-end — describe an outcome in plain English and watch RuFlo decompose it into preconditions, actions, and an A* path through state space, then dispatch the work to live agents at /agents.
| What it is | Why it matters | |
|---|---|---|
| 🎯 | Plain-English goals | Type "ship the auth refactor with tests and a PR" — RuFlo extracts the success criteria, the constraints, and the implicit preconditions. No JSON, no DSL. |
| 🧭 | GOAP A* planner | Classic gaming-AI planning ported to software work: state-space search through actions with preconditions/effects to find the shortest viable path. Replans on the fly when state changes. |
| 🤖 | Live agent dashboard | goal.ruv.io/agents shows every spawned agent — role, current step, memory namespace, token budget, status. Click in to inspect trajectories, kill runaway workers, or reassign. |
| 🌳 | Visual plan tree | Goals render as collapsible action trees with progress, blocked branches, and rollbacks highlighted. See exactly why an agent picked a path — no opaque chain-of-thought. |
| ♻️ | Adaptive replanning | When an action fails or new info arrives, the planner re-runs A* from the current state instead of restarting. Failures become learning, not loops. |
| 🧠 | Shared memory + SONA | Plans, trajectories, and outcomes flow into AgentDB. Future plans retrieve past solutions via HNSW — the planner gets smarter with every run. |
| 🔗 | Wired to MCP tools | Every action node maps to a tool call (RuFlo's ~210 MCP tools, your custom servers, or shell). The planner schedules them in parallel where the dependency graph allows. |
| 🚀 | Zero install to try | Open goal.ruv.io, describe a goal, watch it run. Source lives in v3/goal_ui/ — Vite + Supabase, self-hostable. |
Try it: https://goal.ruv.io/ for goals · https://goal.ruv.io/agents for live agents. Run your own: clone the goal branch and cd v3/goal_ui && npm install && npm run dev.
Agent Federation — Slack for Agents
Your Agent --> [ Remove secrets ] --> [ Sign message ] --> [ Encrypted channel ]
Emails, SSNs, Proves it came No one reads it
keys stripped from you in transit
|
v
Their Agent <-- [ Block attacks ] <-- [ Check identity ] <------+
Stops prompt Rejects forgeries
injection
Audit trail on both sides.
Trust builds over time. Bad behavior = instant downgrade.
Slack gave teams channels. Federation gives agents the same thing — shared workspaces across trust boundaries, where agents on different machines, orgs, or cloud regions can discover each other, prove who they are, and collaborate on tasks.
The difference: some channels are trusted, some aren't. @claude-flow/plugin-agent-federation handles that automatically. Your agents join a federation, get verified via mTLS + ed25519, and start exchanging work — with PII stripped before anything leaves your node and every message auditable. Untrusted agents can still participate at lower privilege: they see discovery info, not your memory. As they prove reliable, trust upgrades. If they misbehave, they get downgraded instantly — no human in the loop required.
You don't configure handshakes or manage certificates. You federation init, federation join, and your agents start talking. The protocol handles identity, the PII pipeline handles data safety, and the audit trail handles compliance.
📘 Full user guide:
docs/federation/— setup, MCP tools, trust levels, circuit breaker, and the (opt-in) WireGuard mesh layer that ties packet-layer reachability to federation trust. ADR-111 deep-dive atdocs/federation/phase7-mesh-bringup.md.
Federation capabilities
| Capability | How it works | |
|---|---|---|
| 🔒 | Zero-trust federation | Remote agents start untrusted. Identity proven via mTLS + ed25519 challenge-response. No API keys, no shared secrets. |
| 🛡️ | PII-gated data flow | 14-type detection pipeline scans every outbound message. Per-trust-level policies: BLOCK, REDACT, HASH, or PASS. Adaptive calibration reduces false positives. |
| 📊 | Behavioral trust scoring | Formula (0.4×success + 0.2×uptime + 0.2×threat + 0.2×integrity) continuously evaluates peers. Upgrades require history; downgrades are instant. |
| 📋 | Compliance built-in | HIPAA, SOC2, GDPR audit trails as compliance modes. Every federation event produces a structured record searchable via HNSW. |
| 🤝 | 9 MCP tools + 10 CLI commands | Full lifecycle: federation_init, federation_send, federation_trust, federation_audit, and more. |
Example: two teams sharing fraud signals without sharing customer data
# Team A: initialize federation and generate keypair
npx claude-flow@latest federation init
# Team A: join Team B's federation endpoint
npx claude-flow@latest federation join wss://team-b.example.com:8443
# Team A: send a task — PII is stripped automatically before it leaves
npx claude-flow@latest federation send --to team-b --type task-request \
--message "Analyze transaction patterns for account anomalies"
# Team A: check peer trust levels and session health
npx claude-flow@latest federation status
See issue #1669 for the complete architecture, trust model, and implementation roadmap.
# Claude Code plugin
/plugin install ruflo-federation@ruflo
# Or via CLI
npx claude-flow@latest plugins install @claude-flow/plugin-agent-federation
Claude Code: With vs Without Ruflo
| Capability | Claude Code Alone | + Ruflo |
|---|---|---|
| Agent Collaboration | Isolated, no shared context | Swarms with shared memory and consensus |
| Coordination | Manual orchestration | Queen-led hierarchy (Raft, Byzantine, Gossip) |
| Memory | Session-only | HNSW vector memory with sub-ms retrieval |
| Learning | Static behavior | SONA self-learning with pattern matching |
| Task Routing | You decide | Intelligent routing (89% accuracy) |
| Background Workers | None | 12 auto-triggered workers |
| LLM Providers | Anthropic only | 5 providers with failover |
| Security | Standard | CVE-hardened with AIDefence |
Architecture overview
User --> Claude Code / CLI
|
v
Orchestration Layer
(MCP Server, Router, 27 Hooks)
|
v
Swarm Coordination
(Queen, Topology, Consensus)
|
v
100+ Specialized Agents
(coder, tester, reviewer, architect, security...)
|
v
Memory & Learning
(AgentDB, HNSW, SONA, ReasoningBank)
|
v
LLM Providers
(Claude, GPT, Gemini, Cohere, Ollama)
Documentation
Four docs for four audiences:
| Doc | When to read it |
|---|---|
| Status | See what currently works — capability counts, test baselines, recent fixes, what's next. The is-it-ready doc. |
| User Guide | Daily reference — every command, every config flag, every plugin. The how-do-I doc. |
| MetaHarness Guide | How to grade your agent setup, scan tool configs for security, detect changes between runs, and eject a project into a standalone agent toolkit. The audit-my-setup doc. |
| Benchmarks | v3.8.0 SOTA matrix vs LangGraph / AutoGen / CrewAI on darwin-arm64 + linux-x64. ruflo wins cold start, single turn, RSS by 1.3×–1953×. The is-it-fast doc. |
| Verification | Cryptographically prove your installed bytes match the signed witness — ruflo verify. The trust-but-verify doc. |
| Team Gateway Checklist | Before-merge gates, dual-mode handoff, memory namespace sharing, and witness manifest entry per merge. The safer-team-workflows doc. |
Benchmark internals (for reproduction): sota-workload-spec.md · SOTA-PROGRESS.md · raw matrix JSON: darwin · linux
User Guide section index:
| Section | Topics |
|---|---|
| Quick Start | Installation, prerequisites, install profiles |
| Core Features | MCP tools, agents, memory, neural learning |
| Intelligence & Learning | Hooks, workers, SONA, model routing |
| Swarm & Coordination | Topologies, consensus, hive mind |
| Security | AIDefence, CVE remediation, validation |
| Ecosystem | RuVector, agentic-flow, Flow Nexus |
| Configuration | Environment variables, config schema |
| Plugin Marketplace | Browse and install plugins |
Support
| Resource | Link |
|---|---|
| Documentation | User Guide |
| Issues & Bugs | GitHub Issues |
| Enterprise | ruv.io |
| Community | Agentics Foundation Discord |
| Powered by | Cognitum.one |
License
MIT - RuvNet
Featured
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Configuration
ANTHROPIC_API_KEYsecretAnthropic API key for Claude AI models
CLAUDE_FLOW_MODEOperation mode: development, production, or test
CLAUDE_FLOW_MEMORY_PATHPath for persistent memory storage
CLAUDE_FLOW_MAX_AGENTSMaximum number of concurrent agents
CLAUDE_FLOW_PORTMCP server port
GITHUB_TOKENsecretGitHub personal access token for repository operations
FLOW_NEXUS_API_KEYsecretFlow Nexus cloud platform API key
Registryactive
Packageclaude-flow
TransportSTDIO
AuthRequired
Tools verifiedJun 10, 2026
UpdatedSep 10, 2025