Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 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

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.md
index cecaf56b54..6429f18c0f 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,11 @@
[![Goal Planner β€” goal.ruv.io](https://img.shields.io/badge/_Goal_Planner-goal.ruv.io-8b5cf6?style=for-the-badge&logoColor=white&logo=react)](https://goal.ruv.io/)
[![Live Agents β€” goal.ruv.io/agents](https://img.shields.io/badge/_Live_Agents-goal.ruv.io%2Fagents-10b981?style=for-the-badge&logoColor=white&logo=react)](https://goal.ruv.io/agents)
+[![npm version (ruflo)](https://img.shields.io/npm/v/ruflo?label=ruflo&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
+[![npm downloads (ruflo)](https://img.shields.io/npm/dm/ruflo?label=ruflo%20downloads&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
+[![npm version (claude-flow)](https://img.shields.io/npm/v/claude-flow?label=claude-flow&style=for-the-badge&logo=npm&color=blue)](https://www.npmjs.com/package/claude-flow)
+[![npm downloads (claude-flow)](https://img.shields.io/npm/dm/claude-flow?label=claude-flow%20downloads&style=for-the-badge&logo=npm&color=blue)](https://www.npmjs.com/package/claude-flow)
+
[![Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/claude-flow)
[![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-D97757?style=for-the-badge&logoColor=white&logo=anthropic)](https://github.com/ruvnet/claude-flow)
diff --git a/package.json b/package.json
index 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.md
index 3995d8aadd..6429f18c0f 100644
--- a/ruflo/README.md
+++ b/ruflo/README.md
@@ -6,12 +6,19 @@
[![Goal Planner β€” goal.ruv.io](https://img.shields.io/badge/_Goal_Planner-goal.ruv.io-8b5cf6?style=for-the-badge&logoColor=white&logo=react)](https://goal.ruv.io/)
[![Live Agents β€” goal.ruv.io/agents](https://img.shields.io/badge/_Live_Agents-goal.ruv.io%2Fagents-10b981?style=for-the-badge&logoColor=white&logo=react)](https://goal.ruv.io/agents)
+[![npm version (ruflo)](https://img.shields.io/npm/v/ruflo?label=ruflo&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
+[![npm downloads (ruflo)](https://img.shields.io/npm/dm/ruflo?label=ruflo%20downloads&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
+[![npm version (claude-flow)](https://img.shields.io/npm/v/claude-flow?label=claude-flow&style=for-the-badge&logo=npm&color=blue)](https://www.npmjs.com/package/claude-flow)
+[![npm downloads (claude-flow)](https://img.shields.io/npm/dm/claude-flow?label=claude-flow%20downloads&style=for-the-badge&logo=npm&color=blue)](https://www.npmjs.com/package/claude-flow)
+
[![Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/claude-flow)
[![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-D97757?style=for-the-badge&logoColor=white&logo=anthropic)](https://github.com/ruvnet/claude-flow)
[![Codex Plugin](https://img.shields.io/badge/Codex-Plugin-412991?style=for-the-badge&logoColor=white&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI%2BPHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0yMi4yODIgOS44MjFhNS45ODUgNS45ODUgMCAwIDAtLjUxNi00LjkxIDYuMDQ2IDYuMDQ2IDAgMCAwLTYuNTEtMi45QTYuMDY1IDYuMDY1IDAgMCAwIDQuOTgxIDQuMThhNS45ODUgNS45ODUgMCAwIDAtMy45OTggMi45IDYuMDQ2IDYuMDQ2IDAgMCAwIC43NDMgNy4wOTcgNS45OCA1Ljk4IDAgMCAwIC41MSA0LjkxMSA2LjA1MSA2LjA1MSAwIDAgMCA2LjUxNSAyLjlBNS45ODUgNS45ODUgMCAwIDAgMTMuMjYgMjRhNi4wNTYgNi4wNTYgMCAwIDAgNS43NzItNC4yMDYgNS45OSA1Ljk5IDAgMCAwIDMuOTk4LTIuOSA2LjA1NiA2LjA1NiAwIDAgMC0uNzQ3LTcuMDczek0xMy4yNiAyMi40M2E0LjQ3NiA0LjQ3NiAwIDAgMS0yLjg3Ni0xLjA0bC4xNDItLjA4IDQuNzc4LTIuNzU4YS43OTUuNzk1IDAgMCAwIC4zOTMtLjY4MXYtNi43MzdsMi4wMiAxLjE2OGEuMDcxLjA3MSAwIDAgMSAuMDM4LjA1MnY1LjU4M2E0LjUwNCA0LjUwNCAwIDAgMS00LjQ5NSA0LjQ5NHpNMy42IDE4LjMwNGE0LjQ3IDQuNDcgMCAwIDEtLjUzNS0zLjAxNGwuMTQyLjA4NSA0Ljc4MyAyLjc1OWEuNzcxLjc3MSAwIDAgMCAuNzgxIDBsNS44NDMtMy4zNjl2Mi4zMzJhLjA4LjA4IDAgMCAxLS4wMzMuMDYyTDkuNzQgMTkuOTVhNC41IDQuNSAwIDAgMS02LjE0LTEuNjQ2ek0yLjM0IDcuODk2YTQuNDg1IDQuNDg1IDAgMCAxIDIuMzY2LTEuOTczVjExLjZhLjc2Ni43NjYgMCAwIDAgLjM4OC42NzdsNS44MTUgMy4zNTQtMi4wMiAxLjE2OGEuMDc2LjA3NiAwIDAgMS0uMDcyIDBsLTQuODMtMi43ODZBNC41MDQgNC41MDQgMCAwIDEgMi4zNCA3Ljg3MnptMTYuNTk3IDMuODU1LTUuODMzLTMuMzg3IDIuMDE2LTEuMTY1YS4wNzYuMDc2IDAgMCAxIC4wNzEgMGw0LjgzIDIuNzkxYTQuNDk0IDQuNDk0IDAgMCAxLS42NzYgOC4xMDR2LTUuNjc3YS43OS43OSAwIDAgMC0uNDA3LS42Njd6bTIuMDEtMy4wMjMtLjE0MS0uMDg1LTQuNzc0LTIuNzgyYS43NzYuNzc2IDAgMCAwLS43ODUgMEw5LjQwOSA5LjIzVjYuODk3YS4wNjYuMDY2IDAgMCAxIC4wMjgtLjA2Mmw0LjgzLTIuNzg3YTQuNDk5IDQuNDk5IDAgMCAxIDYuNjggNC42NnpNOC4zMDcgMTIuODYzbC0yLjAyLTEuMTY0YS4wOC4wOCAwIDAgMS0uMDM4LS4wNTdWNi4wNzRhNC40OTkgNC40OTkgMCAwIDEgNy4zNzYtMy40NTRsLS4xNDIuMDgtNC43NzggMi43NThhLjc5NS43OTUgMCAwIDAtLjM5My42ODJ6bTEuMDk3LTIuMzY2IDIuNjAyLTEuNSAyLjYwNyAxLjV2Mi45OTlsLTIuNTk3IDEuNS0yLjYwNy0xLjVaIi8%2BPC9zdmc%2B)](https://www.npmjs.com/package/@claude-flow/codex)
[![πŸ•ΈοΈ RuVector Graph Ai](https://img.shields.io/badge/RuVector_Agentic-DB-06b6d4?style=for-the-badge&logoColor=white&logo=graphql)](https://github.com/ruvnet/ruvector)
+[![ruFlo Summit β€” Budapest, June 2–3, 2026](v3/docs/assets/ruFlo-Summit.jpg)](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 platform
npx ruflo@latest init wizard
# Quick non-interactive init
@@ -168,6 +181,8 @@ npx ruflo@latest init wizard
npm 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
```bash
diff --git a/ruflo/package.json b/ruflo/package.json
index 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.md
index 8aae9a1132..1f9b12d0d4 100644
--- a/v3/@claude-flow/browser/README.md
+++ b/v3/@claude-flow/browser/README.md
@@ -3,6 +3,7 @@
<div align="center">
[![npm version](https://img.shields.io/npm/v/@claude-flow/browser?style=for-the-badge&logo=npm&color=blue)](https://www.npmjs.com/package/@claude-flow/browser)
+[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/browser?style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/@claude-flow/browser)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-blue?style=for-the-badge&logo=typescript)](https://www.typescriptlang.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![Tests](https://img.shields.io/badge/Tests-128%20passing-green?style=for-the-badge&logo=vitest)](./tests)
diff --git a/v3/@claude-flow/claims/README.md b/v3/@claude-flow/claims/README.md
index fb95502d00..84fdc21480 100644
--- a/v3/@claude-flow/claims/README.md
+++ b/v3/@claude-flow/claims/README.md
@@ -1,5 +1,9 @@
# @claude-flow/claims
+[![npm version](https://img.shields.io/npm/v/@claude-flow/claims.svg)](https://www.npmjs.com/package/@claude-flow/claims)
+[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/claims.svg)](https://www.npmjs.com/package/@claude-flow/claims)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](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.md
index 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
+[![npm version](https://img.shields.io/npm/v/@claude-flow/cli-core.svg)](https://www.npmjs.com/package/@claude-flow/cli-core)
+[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/cli-core.svg)](https://www.npmjs.com/package/@claude-flow/cli-core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](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.md
index 3995d8aadd..6429f18c0f 100644
--- a/v3/@claude-flow/cli/README.md
+++ b/v3/@claude-flow/cli/README.md
@@ -6,12 +6,19 @@
[![Goal Planner β€” goal.ruv.io](https://img.shields.io/badge/_Goal_Planner-goal.ruv.io-8b5cf6?style=for-the-badge&logoColor=white&logo=react)](https://goal.ruv.io/)
[![Live Agents β€” goal.ruv.io/agents](https://img.shields.io/badge/_Live_Agents-goal.ruv.io%2Fagents-10b981?style=for-the-badge&logoColor=white&logo=react)](https://goal.ruv.io/agents)
+[![npm version (ruflo)](https://img.shields.io/npm/v/ruflo?label=ruflo&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
+[![npm downloads (ruflo)](https://img.shields.io/npm/dm/ruflo?label=ruflo%20downloads&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
+[![npm version (claude-flow)](https://img.shields.io/npm/v/claude-flow?label=claude-flow&style=for-the-badge&logo=npm&color=blue)](https://www.npmjs.com/package/claude-flow)
+[![npm downloads (claude-flow)](https://img.shields.io/npm/dm/claude-flow?label=claude-flow%20downloads&style=for-the-badge&logo=npm&color=blue)](https://www.npmjs.com/package/claude-flow)
+
[![Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/claude-flow)
[![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-D97757?style=for-the-badge&logoColor=white&logo=anthropic)](https://github.com/ruvnet/claude-flow)
[![Codex Plugin](https://img.shields.io/badge/Codex-Plugin-412991?style=for-the-badge&logoColor=white&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI%2BPHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0yMi4yODIgOS44MjFhNS45ODUgNS45ODUgMCAwIDAtLjUxNi00LjkxIDYuMDQ2IDYuMDQ2IDAgMCAwLTYuNTEtMi45QTYuMDY1IDYuMDY1IDAgMCAwIDQuOTgxIDQuMThhNS45ODUgNS45ODUgMCAwIDAtMy45OTggMi45IDYuMDQ2IDYuMDQ2IDAgMCAwIC43NDMgNy4wOTcgNS45OCA1Ljk4IDAgMCAwIC41MSA0LjkxMSA2LjA1MSA2LjA1MSAwIDAgMCA2LjUxNSAyLjlBNS45ODUgNS45ODUgMCAwIDAgMTMuMjYgMjRhNi4wNTYgNi4wNTYgMCAwIDAgNS43NzItNC4yMDYgNS45OSA1Ljk5IDAgMCAwIDMuOTk4LTIuOSA2LjA1NiA2LjA1NiAwIDAgMC0uNzQ3LTcuMDczek0xMy4yNiAyMi40M2E0LjQ3NiA0LjQ3NiAwIDAgMS0yLjg3Ni0xLjA0bC4xNDItLjA4IDQuNzc4LTIuNzU4YS43OTUuNzk1IDAgMCAwIC4zOTMtLjY4MXYtNi43MzdsMi4wMiAxLjE2OGEuMDcxLjA3MSAwIDAgMSAuMDM4LjA1MnY1LjU4M2E0LjUwNCA0LjUwNCAwIDAgMS00LjQ5NSA0LjQ5NHpNMy42IDE4LjMwNGE0LjQ3IDQuNDcgMCAwIDEtLjUzNS0zLjAxNGwuMTQyLjA4NSA0Ljc4MyAyLjc1OWEuNzcxLjc3MSAwIDAgMCAuNzgxIDBsNS44NDMtMy4zNjl2Mi4zMzJhLjA4LjA4IDAgMCAxLS4wMzMuMDYyTDkuNzQgMTkuOTVhNC41IDQuNSAwIDAgMS02LjE0LTEuNjQ2ek0yLjM0IDcuODk2YTQuNDg1IDQuNDg1IDAgMCAxIDIuMzY2LTEuOTczVjExLjZhLjc2Ni43NjYgMCAwIDAgLjM4OC42NzdsNS44MTUgMy4zNTQtMi4wMiAxLjE2OGEuMDc2LjA3NiAwIDAgMS0uMDcyIDBsLTQuODMtMi43ODZBNC41MDQgNC41MDQgMCAwIDEgMi4zNCA3Ljg3MnptMTYuNTk3IDMuODU1LTUuODMzLTMuMzg3IDIuMDE2LTEuMTY1YS4wNzYuMDc2IDAgMCAxIC4wNzEgMGw0LjgzIDIuNzkxYTQuNDk0IDQuNDk0IDAgMCAxLS42NzYgOC4xMDR2LTUuNjc3YS43OS43OSAwIDAgMC0uNDA3LS42Njd6bTIuMDEtMy4wMjMtLjE0MS0uMDg1LTQuNzc0LTIuNzgyYS43NzYuNzc2IDAgMCAwLS43ODUgMEw5LjQwOSA5LjIzVjYuODk3YS4wNjYuMDY2IDAgMCAxIC4wMjgtLjA2Mmw0LjgzLTIuNzg3YTQuNDk5IDQuNDk5IDAgMCAxIDYuNjggNC42NnpNOC4zMDcgMTIuODYzbC0yLjAyLTEuMTY0YS4wOC4wOCAwIDAgMS0uMDM4LS4wNTdWNi4wNzRhNC40OTkgNC40OTkgMCAwIDEgNy4zNzYtMy40NTRsLS4xNDIuMDgtNC43NzggMi43NThhLjc5NS43OTUgMCAwIDAtLjM5My42ODJ6bTEuMDk3LTIuMzY2IDIuNjAyLTEuNSAyLjYwNyAxLjV2Mi45OTlsLTIuNTk3IDEuNS0yLjYwNy0xLjVaIi8%2BPC9zdmc%2B)](https://www.npmjs.com/package/@claude-flow/codex)
[![πŸ•ΈοΈ RuVector Graph Ai](https://img.shields.io/badge/RuVector_Agentic-DB-06b6d4?style=for-the-badge&logoColor=white&logo=graphql)](https://github.com/ruvnet/ruvector)
+[![ruFlo Summit β€” Budapest, June 2–3, 2026](v3/docs/assets/ruFlo-Summit.jpg)](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 platform
npx ruflo@latest init wizard
# Quick non-interactive init
@@ -168,6 +181,8 @@ npx ruflo@latest init wizard
npm 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
```bash
diff --git a/v3/@claude-flow/cli/package.json b/v3/@claude-flow/cli/package.json
index 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.md
index 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.json
index 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.md
index 3aa34188c3..70a6b4bcc3 100644
--- a/v3/@claude-flow/mcp/README.md
+++ b/v3/@claude-flow/mcp/README.md
@@ -1,6 +1,7 @@
# @claude-flow/mcp
[![npm version](https://img.shields.io/npm/v/@claude-flow/mcp.svg)](https://www.npmjs.com/package/@claude-flow/mcp)
+[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/mcp.svg)](https://www.npmjs.com/package/@claude-flow/mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
[![MCP 2025-11-25](https://img.shields.io/badge/MCP-2025--11--25-blue.svg)](https://modelcontextprotocol.io)
diff --git a/v3/@claude-flow/memory/package.json b/v3/@claude-flow/memory/package.json
index 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.md
index 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, dist
npm 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.json
index 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.md
index 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
+[![npm version](https://img.shields.io/npm/v/@claude-flow/plugin-agent-federation.svg)](https://www.npmjs.com/package/@claude-flow/plugin-agent-federation)
+[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/plugin-agent-federation.svg)](https://www.npmjs.com/package/@claude-flow/plugin-agent-federation)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
Cross-installation agent federation with zero-trust security, PII-gated data flow, and compliance-grade audit trails.
## Install + run
diff --git a/v3/@claude-flow/plugin-iot-cognitum/README.md b/v3/@claude-flow/plugin-iot-cognitum/README.md
index 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
+[![npm version](https://img.shields.io/npm/v/@claude-flow/plugin-iot-cognitum.svg)](https://www.npmjs.com/package/@claude-flow/plugin-iot-cognitum)
+[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/plugin-iot-cognitum.svg)](https://www.npmjs.com/package/@claude-flow/plugin-iot-cognitum)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
IoT Cognitum Seed device-agent bridge β€” treat every Seed as a Ruflo agent with hardware capabilities.
## Hardware
diff --git a/v3/@claude-flow/plugins/README.md b/v3/@claude-flow/plugins/README.md
index 83364272c5..9e0b9ec4b2 100644
--- a/v3/@claude-flow/plugins/README.md
+++ b/v3/@claude-flow/plugins/README.md
@@ -1,5 +1,9 @@
# @claude-flow/plugins
+[![npm version](https://img.shields.io/npm/v/@claude-flow/plugins.svg)](https://www.npmjs.com/package/@claude-flow/plugins)
+[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/plugins.svg)](https://www.npmjs.com/package/@claude-flow/plugins)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](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.json
index 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",