🌊 @superdisco/claude-flow

SuperDisco's Enhanced Fork - Enterprise AI Agent Orchestration

Transform Claude Code into an enterprise AI orchestration platform

Quick Start • Features • Installation • Documentation • Community

🔄 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

🚀 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 → 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!

🔌 Plugin Installation (Manual)

Install globally with commands:

/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)

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

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

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

claude mcp add claude-flow npx github:superdisco-agents/claude-flow mcp start

Cross-VS Code Setup: See VS Code Cross-Instance Guide

🎬 First Steps

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

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

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

🧠 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

🐝 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

🤖 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

📊 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

🎨 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 - Detailed setup instructions
• Quick Start Tutorial - 5-minute walkthrough
• Skills Tutorial - Natural language activation
• Windows Installation - Special instructions

📖 Core Concepts

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

🔧 Advanced Usage

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

📋 Reference

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

🎓 Examples

Example 1: Semantic Memory Search

# 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

# 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

# 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

# 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

🌐 MCP Servers

Claude-Flow integrates three powerful MCP servers:

🎯 claude-flow (Core - 40+ tools)

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

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

# 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
• GitHub Discussions: Ask questions & share ideas
• Discord: Join the Agentics Foundation
• Documentation: Complete guides and tutorials

🌟 Star History

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development Setup

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

Built with ❤️ by SuperDisco Agents

Powered by Revolutionary AI