---

> 🔄 Fork Notice: This is a fork of the original 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

$3

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

1. Open your project in VS Code
2. Drag 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 - Main drag & drop installer ⭐
- INSTALL_NEW_VSCODE.md - Cross-project setup guide
- QUICK_INSTALL_PROMPT.txt - Copy/paste prompt

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

---

$3

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

$3

#### 🚀 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

#### 🐙 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

$3

`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
`

$3

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 for:
- Authentication setup (GitHub CLI, PAT, SSH)
- Private repository access
- Team deployment patterns
- Offline installation
- Troubleshooting

---

🌟 Features












$3 - 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	$3 - 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
$3 - 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	$3 - PR Management: Reviews, approvals, merging - Code Analysis: Security, performance, quality - Release Automation: Changelogs, versioning - Multi-Repo: Cross-repository operations - 6 Specialized Modes: Workflow automation

$3

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

$3

- Installation Guide - Detailed setup instructions
- Quick Start Tutorial - 5-minute walkthrough
- Skills Tutorial - Natural language activation
- Windows Installation - Special instructions

$3

- Swarm Orchestration - Multi-agent coordination
- ReasoningBank Memory - Persistent storage
- GitHub Integration - PR automation
- MCP Tools - 110+ tools across 3 servers

$3

- Agent Development - Build custom agents
- Hooks System - Automated workflows
- Neural Training - WASM acceleration
- Flow Nexus Cloud - Cloud orchestration

$3

- Command Reference - All 150+ commands
- Agent Catalog - All 76 agents
- API Documentation - Programmatic usage
- Configuration - Settings & customization

---

🎓 Examples

$3

`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"

`

$3

`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

`

$3

`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

`

$3

`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+) │
└─────────────────────────────────────────────────────────────┘
`

$3

| 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

$3

- 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

$3

- 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

$3

- ✅ 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

---

🌐 MCP Servers

Claude-Flow integrates three powerful MCP servers:

$3

`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

$3

`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

$3

`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

$3

- GitHub Issues: Report bugs or request features
- GitHub Discussions: Ask questions & share ideas
- Discord: Join the Agentics Foundation
- Documentation: Complete guides and tutorials

$3









---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

$3

`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
``

$3

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

---

📄 License

MIT License - see LICENSE for details.

---

🙏 Acknowledgments

Built with:
- Claude Code - Anthropic's AI coding assistant
- Agentic-Flow - ReasoningBank memory system
- Spd-Swarm - Swarm coordination library
- Flow-Nexus - Cloud orchestration platform

---

📊 Project Stats

---