π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
release(alpha.43+44): pin neuralβ[email protected], republish modules w/ standalone READMEs, add npm download badges everywhere (#2022)
ruv5b71c7ac135c
diff --git a/README.md b/README.mdindex cecaf56b54..6429f18c0f 100644--- a/README.md+++ b/README.md@@ -6,6 +6,11 @@[](https://goal.ruv.io/)[](https://goal.ruv.io/agents)+[](https://www.npmjs.com/package/ruflo)+[](https://www.npmjs.com/package/ruflo)+[](https://www.npmjs.com/package/claude-flow)+[](https://www.npmjs.com/package/claude-flow)+[](https://github.com/ruvnet/claude-flow)[](https://opensource.org/licenses/MIT)[](https://github.com/ruvnet/claude-flow)diff --git a/package.json b/package.jsonindex 425bd15f4d..530ecd519f 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "claude-flow",- "version": "3.7.0-alpha.42",+ "version": "3.7.0-alpha.44","description": "Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration","main": "dist/index.js","type": "module",diff --git a/ruflo/README.md b/ruflo/README.mdindex 3995d8aadd..6429f18c0f 100644--- a/ruflo/README.md+++ b/ruflo/README.md@@ -6,12 +6,19 @@[](https://goal.ruv.io/)[](https://goal.ruv.io/agents)+[](https://www.npmjs.com/package/ruflo)+[](https://www.npmjs.com/package/ruflo)+[](https://www.npmjs.com/package/claude-flow)+[](https://www.npmjs.com/package/claude-flow)+[](https://github.com/ruvnet/claude-flow)[](https://opensource.org/licenses/MIT)[](https://github.com/ruvnet/claude-flow)[](https://www.npmjs.com/package/@claude-flow/codex)[](https://github.com/ruvnet/ruvector)+[](https://github.com/ruvnet/ruflo/issues/1967)+# Ruflo**Multi-agent AI orchestration for Claude Code**@@ -154,11 +161,17 @@ This adds slash commands and agent definitions only. The Ruflo MCP server is NOT### CLI Install+**macOS / Linux / WSL / Git-Bash:**+```bash-# One-line install+# One-line install (POSIX shells only β see Windows note below)curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash+```-# Or via npx (interactive setup)+**All platforms (including native Windows PowerShell / cmd):**++```bash+# Interactive setup wizard β runs identically on every platformnpx ruflo@latest init wizard# Quick non-interactive init@@ -168,6 +181,8 @@ npx ruflo@latest init wizardnpm install -g ruflo@latest```+> π‘ **Windows users:** the `curl ... | bash` form needs a POSIX shell (Git-Bash, WSL, MSYS). The `npx ruflo@latest init wizard` line works natively in PowerShell and cmd. If you hit an `'bash' is not recognized` error, use the `npx` line instead β both end up running the same init flow.+### MCP Server```bashdiff --git a/ruflo/package.json b/ruflo/package.jsonindex ed9fca63db..1fc0035da0 100644--- a/ruflo/package.json+++ b/ruflo/package.json@@ -1,6 +1,6 @@{"name": "ruflo",- "version": "3.7.0-alpha.42",+ "version": "3.7.0-alpha.44","description": "Ruflo - Enterprise AI agent orchestration platform. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration","main": "bin/ruflo.js","type": "module",diff --git a/v3/@claude-flow/browser/README.md b/v3/@claude-flow/browser/README.mdindex 8aae9a1132..1f9b12d0d4 100644--- a/v3/@claude-flow/browser/README.md+++ b/v3/@claude-flow/browser/README.md@@ -3,6 +3,7 @@<div align="center">[](https://www.npmjs.com/package/@claude-flow/browser)+[](https://www.npmjs.com/package/@claude-flow/browser)[](https://www.typescriptlang.org/)[](https://opensource.org/licenses/MIT)[](./tests)diff --git a/v3/@claude-flow/claims/README.md b/v3/@claude-flow/claims/README.mdindex fb95502d00..84fdc21480 100644--- a/v3/@claude-flow/claims/README.md+++ b/v3/@claude-flow/claims/README.md@@ -1,5 +1,9 @@# @claude-flow/claims+[](https://www.npmjs.com/package/@claude-flow/claims)+[](https://www.npmjs.com/package/@claude-flow/claims)+[](https://opensource.org/licenses/MIT)+**Issue claiming and work coordination for human-agent collaboration.**## What is this?diff --git a/v3/@claude-flow/cli-core/README.md b/v3/@claude-flow/cli-core/README.mdindex 23299b1394..fb515b9d8b 100644--- a/v3/@claude-flow/cli-core/README.md+++ b/v3/@claude-flow/cli-core/README.md@@ -1,5 +1,9 @@# @claude-flow/cli-core+[](https://www.npmjs.com/package/@claude-flow/cli-core)+[](https://www.npmjs.com/package/@claude-flow/cli-core)+[](https://opensource.org/licenses/MIT)+> **Status:** alpha (pre-release). Tracking ADR-100. Don't depend on this in production yet.Lightweight core CLI surface for [Claude Flow](https://github.com/ruvnet/ruflo) β `memory` + `hooks` commands only. Designed to load fast on a cold npx cache so plugin skills don't race Claude Code's 30 second MCP-startup timeout.diff --git a/v3/@claude-flow/cli/README.md b/v3/@claude-flow/cli/README.mdindex 3995d8aadd..6429f18c0f 100644--- a/v3/@claude-flow/cli/README.md+++ b/v3/@claude-flow/cli/README.md@@ -6,12 +6,19 @@[](https://goal.ruv.io/)[](https://goal.ruv.io/agents)+[](https://www.npmjs.com/package/ruflo)+[](https://www.npmjs.com/package/ruflo)+[](https://www.npmjs.com/package/claude-flow)+[](https://www.npmjs.com/package/claude-flow)+[](https://github.com/ruvnet/claude-flow)[](https://opensource.org/licenses/MIT)[](https://github.com/ruvnet/claude-flow)[](https://www.npmjs.com/package/@claude-flow/codex)[](https://github.com/ruvnet/ruvector)+[](https://github.com/ruvnet/ruflo/issues/1967)+# Ruflo**Multi-agent AI orchestration for Claude Code**@@ -154,11 +161,17 @@ This adds slash commands and agent definitions only. The Ruflo MCP server is NOT### CLI Install+**macOS / Linux / WSL / Git-Bash:**+```bash-# One-line install+# One-line install (POSIX shells only β see Windows note below)curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash+```-# Or via npx (interactive setup)+**All platforms (including native Windows PowerShell / cmd):**++```bash+# Interactive setup wizard β runs identically on every platformnpx ruflo@latest init wizard# Quick non-interactive init@@ -168,6 +181,8 @@ npx ruflo@latest init wizardnpm install -g ruflo@latest```+> π‘ **Windows users:** the `curl ... | bash` form needs a POSIX shell (Git-Bash, WSL, MSYS). The `npx ruflo@latest init wizard` line works natively in PowerShell and cmd. If you hit an `'bash' is not recognized` error, use the `npx` line instead β both end up running the same init flow.+### MCP Server```bashdiff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.jsonindex efb96677af..42ae0506da 100644--- a/v3/@claude-flow/cli/package.json+++ b/v3/@claude-flow/cli/package.json@@ -1,6 +1,6 @@{"name": "@claude-flow/cli",- "version": "3.7.0-alpha.42",+ "version": "3.7.0-alpha.44","type": "module","description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code","main": "dist/src/index.js",@@ -97,21 +97,24 @@"dependencies": {"@claude-flow/cli-core": "^3.7.0-alpha.5","@claude-flow/mcp": "^3.0.0-alpha.8",- "@claude-flow/neural": "^3.0.0-alpha.8",+ "@claude-flow/neural": "^3.0.0-alpha.9","@claude-flow/shared": "^3.0.0-alpha.7","@noble/ed25519": "^2.1.0","@ruvector/rabitq-wasm": "^0.1.0","semver": "^7.6.0",- "yaml": "^2.8.0"+ "yaml": "^2.8.0",+ "@claude-flow/memory": "^3.0.0-alpha.17",+ "@claude-flow/embeddings": "^3.0.0-alpha.18",+ "@claude-flow/security": "^3.0.0-alpha.8"},"optionalDependencies": {"@claude-flow/aidefence": "^3.0.2","@claude-flow/codex": "^3.0.0-alpha.8",- "@claude-flow/embeddings": "^3.0.0-alpha.17",+ "@claude-flow/embeddings": "^3.0.0-alpha.18","@claude-flow/guidance": "^3.0.0-alpha.1",- "@claude-flow/memory": "^3.0.0-alpha.16",+ "@claude-flow/memory": "^3.0.0-alpha.17","@claude-flow/plugin-gastown-bridge": "^0.1.3",- "@claude-flow/security": "^3.0.0-alpha.1",+ "@claude-flow/security": "^3.0.0-alpha.8","@ruvector/attention": "^0.1.32","@ruvector/attention-darwin-arm64": "0.1.32","@ruvector/diskann": "^0.1.0",diff --git a/v3/@claude-flow/codex/README.md b/v3/@claude-flow/codex/README.mdindex 506e8705ef..71af4b19b4 100644--- a/v3/@claude-flow/codex/README.md+++ b/v3/@claude-flow/codex/README.md@@ -7,6 +7,7 @@<p align="center"><a href="https://www.npmjs.com/package/@claude-flow/codex"><img src="https://img.shields.io/npm/v/@claude-flow/codex?label=npm&color=blue" alt="npm version"></a>+ <a href="https://www.npmjs.com/package/@claude-flow/codex"><img src="https://img.shields.io/npm/dm/@claude-flow/codex?label=downloads&color=cb3837" alt="npm downloads"></a><a href="https://github.com/ruvnet/ruflo"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a><a href="https://agentics.org"><img src="https://img.shields.io/badge/standard-Agentics-purple" alt="Agentics Standard"></a></p>diff --git a/v3/@claude-flow/embeddings/package.json b/v3/@claude-flow/embeddings/package.jsonindex 4e02efd4b1..bded47fd9a 100644--- a/v3/@claude-flow/embeddings/package.json+++ b/v3/@claude-flow/embeddings/package.json@@ -1,6 +1,6 @@{"name": "@claude-flow/embeddings",- "version": "3.0.0-alpha.17",+ "version": "3.0.0-alpha.18","description": "V3 Embedding Service - OpenAI, Transformers.js, Agentic-Flow (ONNX), Mock providers with hyperbolic embeddings, normalization, and chunking","type": "module","main": "./dist/index.js",diff --git a/v3/@claude-flow/mcp/README.md b/v3/@claude-flow/mcp/README.mdindex 3aa34188c3..70a6b4bcc3 100644--- a/v3/@claude-flow/mcp/README.md+++ b/v3/@claude-flow/mcp/README.md@@ -1,6 +1,7 @@# @claude-flow/mcp[](https://www.npmjs.com/package/@claude-flow/mcp)+[](https://www.npmjs.com/package/@claude-flow/mcp)[](https://opensource.org/licenses/MIT)[](https://www.typescriptlang.org/)[](https://modelcontextprotocol.io)diff --git a/v3/@claude-flow/memory/package.json b/v3/@claude-flow/memory/package.jsonindex 254a5c333d..e832b36202 100644--- a/v3/@claude-flow/memory/package.json+++ b/v3/@claude-flow/memory/package.json@@ -1,6 +1,6 @@{"name": "@claude-flow/memory",- "version": "3.0.0-alpha.16",+ "version": "3.0.0-alpha.17","type": "module","description": "Memory module - AgentDB unification, HNSW indexing, vector search, hybrid SQLite+AgentDB backend (ADR-009)","main": "dist/index.js",diff --git a/v3/@claude-flow/neural/README.md b/v3/@claude-flow/neural/README.mdindex 51d0364706..4ca8274ed2 100644--- a/v3/@claude-flow/neural/README.md+++ b/v3/@claude-flow/neural/README.md@@ -17,14 +17,29 @@ A self-contained learning module that records agent execution trajectories, distnpm install @claude-flow/neural```-> **Known issue (2026-05-16):** `@claude-flow/[email protected]`-> transitively depends on `@ruvector/sona`, and the latest published-> `@ruvector/[email protected]` is an empty release (README + `package.json`-> only β no `index.js`, no native bins). Until a content-bearing-> sona is republished or this package pins `@ruvector/sona@^0.1.5`,-> fresh `npm install`s of `@claude-flow/neural` will fail at import-> time with `Cannot find package 'β¦/node_modules/@ruvector/sona/index.js'`.-> See ruvnet/ruflo for a tracking issue.+> **Note (2026-05-16):** `@claude-flow/[email protected]+` pins+> `@ruvector/sona` to the exact known-good `0.1.5` because+> `@ruvector/[email protected]` shipped as an empty publish (README ++> `package.json` only β no `index.js`, no native bins). Prior alpha.8+> used `"latest"` and broke on every fresh install. The pin will+> stay until `@ruvector/[email protected]+` ships with content.++## Standalone use (without the Ruflo CLI)++```typescript+// route a task across 8 specialized experts (MoE) β no other deps+import { getMoERouter } from '@claude-flow/neural';++const router = getMoERouter();+await router.initialize();++const decision = await router.route(+ new Float32Array(384).fill(0.1), // task embedding+ { task: 'optimize-query', complexity: 0.7 },+);+console.log(decision.expert, decision.confidence);+// β 'performance', 0.83 (or whichever expert wins)+```## Quick start (recommended)diff --git a/v3/@claude-flow/neural/package.json b/v3/@claude-flow/neural/package.jsonindex 90d254480c..969249ff74 100644--- a/v3/@claude-flow/neural/package.json+++ b/v3/@claude-flow/neural/package.json@@ -1,6 +1,6 @@{"name": "@claude-flow/neural",- "version": "3.0.0-alpha.8",+ "version": "3.0.0-alpha.9","type": "module","description": "Self-Optimizing Neural Architecture (SONA) for Claude Flow β adaptive learning, trajectory tracking, pattern reuse, 7 RL algorithms (PPO/A2C/DQN/Q-Learning/SARSA/Decision Transformer/Curiosity), Flash Attention, MoE routing, LoRA, EWC++ for continual learning. Reproducible via seedable PRNG; persistence via serialize/deserialize.","main": "dist/index.js",@@ -121,8 +121,8 @@"LICENSE"],"dependencies": {- "@claude-flow/memory": "^3.0.0-alpha.2",- "@ruvector/sona": "latest"+ "@claude-flow/memory": "^3.0.0-alpha.16",+ "@ruvector/sona": "0.1.5"},"optionalDependencies": {"agentdb": "^2.0.0 || ^3.0.0-alpha.1"diff --git a/v3/@claude-flow/plugin-agent-federation/README.md b/v3/@claude-flow/plugin-agent-federation/README.mdindex fa48fc0e6e..32de1e6417 100644--- a/v3/@claude-flow/plugin-agent-federation/README.md+++ b/v3/@claude-flow/plugin-agent-federation/README.md@@ -1,5 +1,9 @@# @claude-flow/plugin-agent-federation+[](https://www.npmjs.com/package/@claude-flow/plugin-agent-federation)+[](https://www.npmjs.com/package/@claude-flow/plugin-agent-federation)+[](https://opensource.org/licenses/MIT)+Cross-installation agent federation with zero-trust security, PII-gated data flow, and compliance-grade audit trails.## Install + rundiff --git a/v3/@claude-flow/plugin-iot-cognitum/README.md b/v3/@claude-flow/plugin-iot-cognitum/README.mdindex 3a4bb0c6aa..5ad2d61123 100644--- a/v3/@claude-flow/plugin-iot-cognitum/README.md+++ b/v3/@claude-flow/plugin-iot-cognitum/README.md@@ -1,5 +1,9 @@# @claude-flow/plugin-iot-cognitum+[](https://www.npmjs.com/package/@claude-flow/plugin-iot-cognitum)+[](https://www.npmjs.com/package/@claude-flow/plugin-iot-cognitum)+[](https://opensource.org/licenses/MIT)+IoT Cognitum Seed device-agent bridge β treat every Seed as a Ruflo agent with hardware capabilities.## Hardwarediff --git a/v3/@claude-flow/plugins/README.md b/v3/@claude-flow/plugins/README.mdindex 83364272c5..9e0b9ec4b2 100644--- a/v3/@claude-flow/plugins/README.md+++ b/v3/@claude-flow/plugins/README.md@@ -1,5 +1,9 @@# @claude-flow/plugins+[](https://www.npmjs.com/package/@claude-flow/plugins)+[](https://www.npmjs.com/package/@claude-flow/plugins)+[](https://opensource.org/licenses/MIT)+**Unified Plugin SDK for Claude Flow V3**A comprehensive plugin development framework providing workers, hooks, providers, and security utilities for building Claude Flow extensions.diff --git a/v3/@claude-flow/security/package.json b/v3/@claude-flow/security/package.jsonindex 09b70cc627..5cbb0fca20 100644--- a/v3/@claude-flow/security/package.json+++ b/v3/@claude-flow/security/package.json@@ -1,6 +1,6 @@{"name": "@claude-flow/security",- "version": "3.0.0-alpha.7",+ "version": "3.0.0-alpha.8","type": "module","description": "Security module - CVE fixes, input validation, path security","main": "dist/index.js",