π 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
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
Claude Flow Plugin Integration
Overview
This document describes how claude-flow integrates with the official Claude Code plugin system.
Plugin Structure
plugin/
βββ .claude-plugin/
β βββ plugin.json # Official plugin manifest
βββ .mcp.json # MCP server bundle
βββ hooks/
β βββ hooks.json # Hook configurations
βββ skills -> ../.claude/skills # 60+ skills
βββ commands -> ../.claude/commands # 100+ commands
βββ agents -> ../v2/.claude/agents # 80+ agents
Official Claude Code Integration Points
1. Plugin Manifest (plugin.json)
{
"name": "claude-flow",
"version": "3.0.0",
"capabilities": {
"skills": true,
"commands": true,
"agents": true,
"hooks": true,
"mcpServers": true
}
}
2. Hook Event Mapping
| V3 Internal Event | Official Claude Code Event | Tool Matcher |
|---|---|---|
PreEdit |
PreToolUse |
^(Write|Edit|MultiEdit)$ |
PostEdit |
PostToolUse |
^(Write|Edit|MultiEdit)$ |
PreCommand |
PreToolUse |
^Bash$ |
PostCommand |
PostToolUse |
^Bash$ |
PreTask |
UserPromptSubmit |
- |
PostTask |
PostToolUse |
^Task$ |
SessionStart |
SessionStart |
- |
SessionEnd |
Stop |
- |
AgentSpawn |
PostToolUse |
^Task$ |
AgentTerminate |
SubagentStop |
- |
PreRoute |
UserPromptSubmit |
- |
3. MCP Server Bundle
The plugin bundles three MCP servers:
- claude-flow (required): Core swarm coordination
- ruv-swarm (optional): Enhanced topology patterns
- flow-nexus (optional): Cloud orchestration
4. Skills Integration
Skills follow the official SKILL.md format:
---
name: skill-name
description: What this skill does
allowed-tools: Read, Write, Bash
---
# Skill Name
[Instructions for Claude]
V3 Hooks Bridge
The @claude-flow/hooks package includes an official hooks bridge:
import {
OfficialHooksBridge,
processOfficialHookInput,
outputOfficialHookResult,
executeWithBridge,
} from '@claude-flow/hooks';
// Process input from Claude Code
const input = await processOfficialHookInput();
// Convert to V3 context
const context = OfficialHooksBridge.toV3Context(input);
// Execute V3 handler
const result = await handler(context);
// Convert back to official output
const output = OfficialHooksBridge.toOfficialOutput(result, input.hook_event_name);
outputOfficialHookResult(output);
Installation
Via Plugin Command (Recommended)
# Add plugin marketplace
/plugin marketplace add claude-flow https://github.com/ruvnet/claude-flow
# Install plugin
/plugin install claude-flow
Manual Installation
# Clone and link
git clone https://github.com/ruvnet/claude-flow
claude --plugin-dir ./claude-flow/plugin
Via npx Init
npx claude-flow@alpha init --hooks
Configuration
Enable All Hooks
Add to .claude/settings.json:
{
"hooks": {
"PreToolUse": [...],
"PostToolUse": [...],
"UserPromptSubmit": [...],
"SessionStart": [...],
"Stop": [...]
}
}
Selective Hooks
Enable only specific hooks by choosing matchers:
{
"hooks": {
"PreToolUse": [
{
"matcher": "^(Write|Edit)$",
"hooks": [{ "type": "command", "command": "npx claude-flow@alpha hooks pre-edit" }]
}
]
}
}
MCP Tool Access
After installation, MCP tools are available:
mcp__claude-flow__swarm_initmcp__claude-flow__agent_spawnmcp__claude-flow__task_orchestratemcp__claude-flow__memory_usagemcp__claude-flow__hooks_routemcp__claude-flow__hooks_metrics
Marketplace Publishing
Create Marketplace Entry
{
"name": "claude-flow-marketplace",
"plugins": [
{
"name": "claude-flow",
"description": "Multi-agent swarm coordination",
"version": "3.0.0",
"path": "plugin"
}
]
}
Host on GitHub
- Push to repository
- Add marketplace:
/plugin marketplace add name https://github.com/user/repo - Users install:
/plugin install claude-flow@name
Architecture
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Claude Code β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Official Hooks API β
β βββββββββββββββ¬ββββββββββββββ¬ββββββββββββββ¬βββββββββββββββ β
β β PreToolUse β PostToolUse β SessionStartβ UserPrompt β β
β ββββββββ¬βββββββ΄βββββββ¬βββββββ΄βββββββ¬βββββββ΄βββββββ¬ββββββββ β
β β β β β β
β βΌ βΌ βΌ βΌ β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β Official Hooks Bridge ββ
β β (v3/@claude-flow/hooks/src/bridge/official-hooks-bridge)ββ
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β β β β β
β βΌ βΌ βΌ βΌ β
β βββββββββββββββ¬ββββββββββββββ¬ββββββββββββββ¬βββββββββββββββ β
β β PreEdit β PostEdit β SessionStartβ PreTask β β
β β PreCommand β PostCommand β SessionEnd β PostTask β β
β βββββββββββββββ΄ββββββββββββββ΄ββββββββββββββ΄βββββββββββββββ β
β V3 Hooks System β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β @claude-flow/hooks β
β βββββββββββββ¬ββββββββββββ¬ββββββββββββ¬ββββββββββββββββββββ β
β β Registry β Executor β Daemons β MCP Tools β β
β βββββββββββββ΄ββββββββββββ΄ββββββββββββ΄ββββββββββββββββββββ β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Skills β Commands β Agents β MCP Servers β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Benefits
- Seamless Integration: V3 hooks map directly to official events
- Full Feature Access: 60+ skills, 100+ commands, 80+ agents
- MCP Bundling: All servers configured in one file
- Marketplace Ready: Standard plugin format for distribution
- Backward Compatible: Works with existing
.claude/configurations