📦 Claude Flow Plugin Installation Guide

Quick Installation

Method 1: Install from GitHub (Recommended)

In Claude Code:

/plugin add ruvnet/claude-flow

This will:

• Clone the repository
• Install all 150+ commands
• Install all 74+ agents
• Configure MCP servers
• Set up hooks

Method 2: Install from Local Directory

If you've cloned the repository:

# Clone the repository
git clone https://github.com/ruvnet/claude-flow.git
cd claude-flow

# In Claude Code, install the plugin
/plugin add .

Step 2: Restart Claude Code

Restart to activate the plugin:

/restart

Step 3: Verify Installation

/plugin list

Look for claude-flow in the active plugins list.

Try a command:

/coordination-swarm-init

Or type / to see all 150+ available commands.

What Gets Installed

✅ 150+ Slash Commands

Commands organized by category:

• Coordination (6): swarm-init, agent-spawn, task-orchestrate
• SPARC (18): coder, tdd, architect, reviewer, optimizer
• GitHub (18): pr-manager, code-review-swarm, release-manager
• Hive Mind (11): init, spawn, consensus, memory
• Memory (5): usage, persist, search
• Monitoring (5): status, agents, metrics
• Optimization (5): topology-optimize, parallel-execution
• Analysis (5): performance-report, bottleneck-detect
• Automation (6): smart-spawn, auto-agent
• Swarm (15): init, spawn, status, monitor
• Workflows (5): create, execute, export
• Training (5): neural-train, pattern-learn
• Flow Nexus (9): swarm, workflow, sandbox
• And more...

✅ 74+ Specialized Agents

Available for delegation:

• Core Development (5): coder, planner, researcher, reviewer, tester
• Swarm Coordination (5): hierarchical, mesh, adaptive coordinators
• Consensus (7): Byzantine, Raft, Gossip protocols
• GitHub (13): PR manager, code review, releases
• Specialized (8): backend, mobile, ML, CI/CD
• And more...

✅ MCP Integration

3 MCP servers with 110+ tools:

• claude-flow: Core orchestration (40+ tools) - Required
• ruv-swarm: Enhanced coordination - Optional
• flow-nexus: Cloud features (70+ tools) - Optional

Managing the Plugin

List Installed Plugins

/plugin list

Update Plugin

/plugin update claude-flow

Or pull latest from GitHub:

cd /path/to/claude-flow
git pull

Remove Plugin

/plugin remove claude-flow

MCP Server Setup (Optional)

The plugin defines MCP servers, but you may need to install the packages:

Install MCP Packages

# Core MCP (recommended)
npm install -g claude-flow@alpha

# Optional enhanced coordination
npm install -g ruv-swarm

# Optional cloud features (requires authentication)
npm install -g flow-nexus@latest

MCP servers are automatically configured when you install the plugin.

Verification

Check Plugin Status

In Claude Code:

/plugin list

Look for claude-flow in the list with status "active".

Test Commands

Type / in Claude Code and look for:

• Commands starting with coordination-
• Commands starting with sparc-
• Commands starting with github-
• Commands starting with hive-mind-

Test Agents

Agents are automatically available for Claude Code to delegate to when appropriate.

Troubleshooting

Plugin Not Found

# Verify plugin is installed
/plugin list

# Try installing again
/plugin add ruvnet/claude-flow

Commands Not Showing

# Verify plugin is installed
/plugin list

# Check directory structure
ls -la .claude-plugin/
ls -la commands/
ls -la agents/

# Restart Claude Code
/restart

Installation Fails

# Try local installation
git clone https://github.com/ruvnet/claude-flow.git
cd claude-flow
/plugin add .

Getting Help

• Documentation: See README.md for complete documentation
• Quick Start: See docs/QUICKSTART.md for 5-minute guide
• GitHub Issues: https://github.com/ruvnet/claude-flow/issues
• Discussions: https://github.com/ruvnet/claude-flow/discussions

Uninstalling

To remove the plugin:

/plugin remove claude-flow

This will remove all commands, agents, and hooks.

Version: 2.5.0 License: MIT Author: rUv

Plugin Structure

After installation, the plugin structure is:

claude-flow/
├── .claude-plugin/
│   ├── plugin.json          # Plugin metadata
│   ├── README.md            # Documentation
│   ├── INSTALLATION.md      # This file
│   └── PLUGIN_SUMMARY.md    # Status overview
├── commands/                 # 150+ slash commands
│   ├── coordination/
│   ├── sparc/
│   ├── github/
│   ├── hive-mind/
│   └── ...
├── agents/                   # 74+ specialized agents
│   ├── core/
│   ├── swarm/
│   ├── consensus/
│   ├── github/
│   └── ...
└── hooks/                    # Event handlers
    └── hooks.json