npm package: @rdmptv/claude-flow
Description: SuperDisco fork: Enterprise-grade AI agent orchestration with WASM-powered ReasoningBank memory and AgentDB vector database (GitHub distribution)
Author: SuperDisco Agents
Latest version: 2.7.0-alpha.14

<div align="center">

# 🌊 @superdisco/claude-flow

### SuperDisco's Enhanced Fork - Enterprise AI Agent Orchestration

[![🌟 Star on GitHub](https://img.shields.io/github/stars/superdisco-agents/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/superdisco-agents/claude-flow)
[![📦 GitHub Distribution](https://img.shields.io/badge/Distribution-GitHub-blue?style=for-the-badge&logo=github)](https://github.com/superdisco-agents/claude-flow)
[![⚡ Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-purple?style=for-the-badge&logo=anthropic)](https://github.com/superdisco-agents/claude-flow)
[![🛡️ MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](LICENSE)

**Transform Claude Code into an enterprise AI orchestration platform**

[Quick Start](#-quick-start) • [Features](#-features) • [Installation](#-installation) • [Documentation](#-documentation) • [Community](#-community)

</div>

---

> **🔄 Fork Notice**: This is a fork of the original [claude-flow](https://github.com/superdisco/claude-flow) by rUv. Due to extensive code modifications and feature enhancements, this project has been rebranded under the SuperDisco Agents organization.

---

## 🎯 What is Claude-Flow?

**Claude-Flow** is an enterprise-grade plugin for Claude Code that adds:

- 🤖 **76 Specialized AI Agents** across 20 categories
- ⚡ **150+ Commands** for orchestration, GitHub, memory, and automation
- 🧠 **ReasoningBank Memory** - Persistent SQLite with semantic search (2-3ms)
- 🐝 **Swarm Intelligence** - Multi-agent coordination with hive-mind patterns
- 📊 **GitHub Automation** - PR reviews, code analysis, release management
- 🎨 **25 Natural Language Skills** - No commands to memorize
- 🔧 **110+ MCP Tools** - Comprehensive toolkit across 3 servers

> 🚀 **One-Line Install**: Transform Claude Code into a multi-agent orchestration platform in seconds

---

## ⚡ Quick Start

### 🚀 Quick Install (Drag & Drop) ⭐ EASIEST!

**Zero commands to type - Perfect for any VS Code instance!**

1. **Open your project** in VS Code
2. **Drag** [`DRAG_DROP_INSTALL.md`](DRAG_DROP_INSTALL.md) → Drop into Claude Code
3. **Press Enter** when prompted
4. ✅ **Auto-installs in ~60 seconds!**

📖 **Three Installation Files Available**:
- [**DRAG_DROP_INSTALL.md**](DRAG_DROP_INSTALL.md) - Main drag & drop installer ⭐
- [**INSTALL_NEW_VSCODE.md**](INSTALL_NEW_VSCODE.md) - Cross-project setup guide
- [**QUICK_INSTALL_PROMPT.txt**](QUICK_INSTALL_PROMPT.txt) - Copy/paste prompt

🎯 **Use in Different VS Code?** Just drag the file again!

---

### 🔌 Plugin Installation (Manual)

Install globally with commands:

```bash
/plugin marketplace add superdisco-agents/claude-flow
/plugin install claude-flow@superdisco-agents/claude-flow
```

✅ **Automatic Setup:**
- All MCP servers registered (`claude-flow`, `spd-swarm`, `flow-nexus`)
- 76 agents immediately available
- 150+ commands ready to use
- Memory system initialized

### 📦 Installation Methods

#### 🚀 One-Liner Installation (Easiest)

```bash
# Auto-detects and installs best available method
curl -fsSL https://raw.githubusercontent.com/superdisco-agents/claude-flow/main/scripts/install-mcp.sh | bash
```

#### 📦 NPM Installation (Recommended - When Published)

**Fastest method once published to npm:**

```bash
# Install alpha version
claude mcp add claude-flow npx @superdisco/claude-flow@alpha mcp start

# Or install stable version (when available)
claude mcp add claude-flow npx @superdisco/claude-flow mcp start
```

**Status**: ⏳ Coming soon! Follow [NPM Publishing Guide](docs/NPM_PUBLISHING_GUIDE.md)

#### 🐙 GitHub Installation (Current Default)

**SuperDisco fork uses GitHub distribution:**

```bash
# Install directly from GitHub
npx github:superdisco-agents/claude-flow init --force

# Verify installation
npx github:superdisco-agents/claude-flow --version
# v2.7.0-alpha.14 (@superdisco/claude-flow)
```

**Add to Claude Code MCP:**
```bash
claude mcp add claude-flow npx github:superdisco-agents/claude-flow mcp start
```

**Cross-VS Code Setup**: See [VS Code Cross-Instance Guide](docs/VSCODE_CROSS_INSTANCE_SETUP.md)

### 🎬 First Steps

```bash
# Try natural language skills
"Review this PR for security issues"
"Create a swarm to build this API"
"Use semantic search to find similar code"

# Or use commands directly
npx github:superdisco-agents/claude-flow swarm "build REST API" --claude
npx github:superdisco-agents/claude-flow memory store api_key "API configuration" --reasoningbank
npx github:superdisco-agents/claude-flow github pr-review --security
```

### 🔐 Private Team Installation

**For teams using private GitHub repositories:**

```bash
# 1. Ensure you have repository access
gh auth status  # Verify GitHub authentication

# 2. Add private marketplace
/plugin marketplace add superdisco-agents/claude-flow

# 3. Install plugin
/plugin install claude-flow@superdisco-agents/claude-flow

# 4. Verify installation
./scripts/verify-installation.sh
```

**Team Auto-Installation**: Place `.claude/settings.json` in your project:

```json
{
  "extraKnownMarketplaces": {
    "superdisco-agents": {
      "source": {
        "source": "github",
        "repo": "superdisco-agents/claude-flow"
      }
    }
  }
}
```

📚 **Complete Team Guide**: See [`docs/INSTALL-MARKETPLACE.md`](docs/INSTALL-MARKETPLACE.md) for:
- Authentication setup (GitHub CLI, PAT, SSH)
- Private repository access
- Team deployment patterns
- Offline installation
- Troubleshooting

---

## 🌟 Features

<table>
<tr>
<td width="50%">

### 🧠 Intelligence & Memory

- **ReasoningBank**: Persistent SQLite memory
- **Semantic Search**: 2-3ms query latency
- **No API Keys**: Hash-based embeddings
- **Namespace Isolation**: Organize by domain
- **AgentDB Integration**: 150x-12,500x performance

</td>
<td width="50%">

### 🐝 Swarm Orchestration

- **Hive-Mind Intelligence**: Queen-led coordination
- **Dynamic Agent Architecture**: Self-organizing
- **4 Topologies**: Hierarchical, Mesh, Ring, Star
- **Fault Tolerance**: Auto-recovery & retries
- **Session Management**: Persistent workflows

</td>
</tr>
<tr>
<td width="50%">

### 🤖 Agent System

- **76 Specialized Agents** in 20 categories
- **SPARC Methodology**: 18 development modes
- **Auto-Activation**: Natural language detection
- **Context-Aware**: Understands project state
- **Customizable**: Build your own agents

</td>
<td width="50%">

### 📊 GitHub Integration

- **PR Management**: Reviews, approvals, merging
- **Code Analysis**: Security, performance, quality
- **Release Automation**: Changelogs, versioning
- **Multi-Repo**: Cross-repository operations
- **6 Specialized Modes**: Workflow automation

</td>
</tr>
</table>

### 🎨 Natural Language Skills (25 Total)

No commands to memorize - just describe what you want:

| Category | Skills | Example Trigger |
|----------|--------|-----------------|
| 🔧 **Development** | SPARC, Pair Programming, Skill Builder | "Let's pair program on this" |
| 🧠 **Memory** | Vector Search, AgentDB, ReasoningBank | "Search my notes for X" |
| 🐝 **Swarm** | Orchestration, Hive-Mind, Coordination | "Create a swarm to build Y" |
| 📊 **GitHub** | PR Review, Workflows, Releases | "Review this PR for security" |
| ⚙️ **Automation** | Hooks, Verification, Performance | "Set up pre-commit hooks" |
| 🌐 **Cloud** | Flow Nexus, E2B Sandboxes | "Run this in a sandbox" |

---

## 📚 Documentation

### 🚀 Getting Started

- [Installation Guide](./docs/installation.md) - Detailed setup instructions
- [Quick Start Tutorial](./docs/quickstart.md) - 5-minute walkthrough
- [Skills Tutorial](./docs/skills-tutorial.md) - Natural language activation
- [Windows Installation](./docs/windows-installation.md) - Special instructions

### 📖 Core Concepts

- [Swarm Orchestration](./docs/swarm-orchestration.md) - Multi-agent coordination
- [ReasoningBank Memory](./docs/reasoningbank-memory.md) - Persistent storage
- [GitHub Integration](./docs/github-integration.md) - PR automation
- [MCP Tools](./docs/mcp-tools.md) - 110+ tools across 3 servers

### 🔧 Advanced Usage

- [Agent Development](./docs/agent-development.md) - Build custom agents
- [Hooks System](./docs/hooks-system.md) - Automated workflows
- [Neural Training](./docs/neural-training.md) - WASM acceleration
- [Flow Nexus Cloud](./docs/flow-nexus.md) - Cloud orchestration

### 📋 Reference

- [Command Reference](./docs/commands.md) - All 150+ commands
- [Agent Catalog](./docs/agents.md) - All 76 agents
- [API Documentation](./docs/api.md) - Programmatic usage
- [Configuration](./docs/configuration.md) - Settings & customization

---

## 🎓 Examples

### Example 1: Semantic Memory Search

```bash
# Store memories with context
npx claude-flow@alpha memory store api_config "REST API on port 3000" \
  --namespace backend --reasoningbank

# Query with semantic search (2-3ms)
npx claude-flow@alpha memory query "API configuration" \
  --namespace backend --reasoningbank

# ✅ Found 1 result (match: 87.3%)
# 📌 api_config: "REST API on port 3000"
```

### Example 2: PR Security Review

```bash
# Automated security analysis
npx claude-flow@alpha github pr-review \
  --security \
  --mode strict \
  --pr 123

# Checks:
# ✅ SQL injection vulnerabilities
# ✅ XSS attack vectors
# ✅ Authentication bypasses
# ✅ Secrets in code
# ✅ Dependency vulnerabilities
```

### Example 3: Swarm-Based Development

```bash
# Create multi-agent swarm
npx claude-flow@alpha swarm init --topology mesh
npx claude-flow@alpha swarm spawn researcher "analyze requirements"
npx claude-flow@alpha swarm spawn architect "design system"
npx claude-flow@alpha swarm spawn coder "implement features"

# Monitor progress
npx claude-flow@alpha swarm status
# ✅ 3 agents active, 2 tasks complete
```

### Example 4: Hive-Mind for Enterprise Projects

```bash
# Interactive wizard setup
npx claude-flow@alpha hive-mind wizard

# Spawn coordinated agents
npx claude-flow@alpha hive-mind spawn \
  "build e-commerce platform" \
  --claude

# Session persists in SQLite
npx claude-flow@alpha hive-mind resume session-xxxxx
```

---

## 🛠️ Architecture

```
┌─────────────────────────────────────────────────────────────┐
│                    Claude Code Plugin                        │
├─────────────────────────────────────────────────────────────┤
│  🎨 Skills (25)     │  🤖 Agents (76)   │  ⚡ Commands (150+)│
├─────────────────────────────────────────────────────────────┤
│              🧠 ReasoningBank Memory Layer                   │
│           (SQLite + Semantic Search + 2-3ms)                 │
├─────────────────────────────────────────────────────────────┤
│                  🐝 Swarm Orchestration                      │
│        (Hive-Mind + Dynamic Agents + 4 Topologies)           │
├─────────────────────────────────────────────────────────────┤
│                   🔧 MCP Tools (110+)                        │
│  claude-flow (40) │ spd-swarm (50+) │ flow-nexus (70+)      │
└─────────────────────────────────────────────────────────────┘
```

### Core Components

| Component | Description | Performance |
|-----------|-------------|-------------|
| **ReasoningBank** | Persistent SQLite memory with semantic search | 2-3ms queries |
| **AgentDB** | Vector database for agent coordination | 150x-12,500x faster |
| **Swarm Engine** | Multi-agent orchestration with 4 topologies | Auto-scaling |
| **MCP Integration** | 110+ tools across 3 servers | Real-time |
| **GitHub Automation** | 6 specialized modes for repo management | Webhook-based |

---

## 🆕 What's New in v2.7.0

### ✅ Critical Fixes

- **Semantic Search Fixed**: Resolved 0-results bug in memory queries
- **Plugin Marketplace**: Schema-compliant for global installation
- **Node.js Backend**: Replaced WASM with SQLite for better performance
- **Parameter Alignment**: Fixed namespace vs domain mismatch

### 🚀 New Features

- **Global Plugin Installation**: One-command setup via Claude Code marketplace
- **Enhanced Memory**: Persistent `.swarm/memory.db` with MMR ranking
- **Improved Embeddings**: Hash-based (no API keys) or OpenAI (optional)
- **Better Performance**: 2-3ms query latency, 400KB per pattern

### 📊 Stats

- ✅ **84.8%** SWE-Bench solve rate
- ✅ **2-3ms** semantic search latency
- ✅ **150x-12,500x** AgentDB performance improvement
- ✅ **110+** MCP tools across 3 servers

📚 [Full Release Notes](./docs/RELEASE-NOTES-v2.7.0-alpha.14.md)

---

## 🌐 MCP Servers

Claude-Flow integrates three powerful MCP servers:

### 🎯 claude-flow (Core - 40+ tools)

```bash
# Automatically registered during plugin install
# Provides: Swarm coordination, agent management, memory operations
```

**Key Tools:**
- `swarm_coordinate` - Multi-agent orchestration
- `memory_store` - ReasoningBank integration
- `agent_spawn` - Dynamic agent creation
- `hive_mind_init` - Queen-led coordination

### 🔄 spd-swarm (Enhanced - 50+ tools)

```bash
# Optional: Advanced swarm features
# Provides: WASM acceleration, neural training, advanced topologies
```

**Key Tools:**
- `neural_train` - WASM-accelerated learning (2.8-4.4x speed)
- `topology_optimize` - Dynamic topology selection
- `swarm_analyze` - Performance monitoring
- `fault_recovery` - Auto-healing mechanisms

### ☁️ flow-nexus (Cloud - 70+ tools)

```bash
# Optional: Cloud orchestration platform
# Provides: E2B sandboxes, marketplace, challenges
```

**Key Tools:**
- `sandbox_create` - Isolated execution environments
- `marketplace_publish` - Agent sharing
- `challenge_submit` - SWE-Bench evaluation
- `cloud_coordinate` - Distributed swarms

---

## 🤝 Community

### 💬 Get Help & Connect

- **GitHub Issues**: [Report bugs or request features](https://github.com/superdisco-agents/claude-flow/issues)
- **GitHub Discussions**: [Ask questions & share ideas](https://github.com/superdisco-agents/claude-flow/discussions)
- **Discord**: [Join the Agentics Foundation](https://discord.com/invite/dfxmpwkG2D)
- **Documentation**: [Complete guides and tutorials](https://github.com/superdisco-agents/claude-flow/wiki)

### 🌟 Star History

<a href="https://www.star-history.com/#superdisco-agents/claude-flow&Date">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=superdisco-agents/claude-flow&type=Date&theme=dark" />
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=superdisco-agents/claude-flow&type=Date" />
    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=superdisco-agents/claude-flow&type=Date" />
  </picture>
</a>

---

## 🤝 Contributing

We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.

### Development Setup

```bash
# Clone repository
git clone https://github.com/superdisco-agents/claude-flow.git
cd claude-flow

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build
```

### Code Standards

- **TypeScript**: Strict mode enabled
- **Testing**: Jest with 80%+ coverage
- **Linting**: ESLint + Prettier
- **Commits**: Conventional Commits format

---

## 📄 License

MIT License - see [LICENSE](./LICENSE) for details.

---

## 🙏 Acknowledgments

Built with:
- [Claude Code](https://claude.com/code) - Anthropic's AI coding assistant
- [Agentic-Flow](https://github.com/superdisco-agents/agentic-flow) - ReasoningBank memory system
- [Spd-Swarm](https://github.com/superdisco-agents/spd-swarm) - Swarm coordination library
- [Flow-Nexus](https://github.com/superdisco-agents/flow-nexus) - Cloud orchestration platform

---

## 📊 Project Stats

<div align="center">

![GitHub repo size](https://img.shields.io/github/repo-size/superdisco-agents/claude-flow?style=flat-square)
![GitHub code size](https://img.shields.io/github/languages/code-size/superdisco-agents/claude-flow?style=flat-square)
![GitHub language count](https://img.shields.io/github/languages/count/superdisco-agents/claude-flow?style=flat-square)
![GitHub top language](https://img.shields.io/github/languages/top/superdisco-agents/claude-flow?style=flat-square)
![GitHub last commit](https://img.shields.io/github/last-commit/superdisco-agents/claude-flow?style=flat-square)

</div>

---

<div align="center">

**Built with ❤️ by [SuperDisco Agents](https://github.com/superdisco-agents)**

**Powered by Revolutionary AI**

</div>