Claude-Flow v2 Alpha is an enterprise-grade AI orchestration platform that revolutionizes how developers build with AI. By combining hive-mind swarm intelligence, neural pattern recognition, and 87 advanced MCP tools, Claude-Flow enables unprecedented AI-powered development workflows.
- 🐝 Hive-Mind Intelligence: Queen-led AI coordination with specialized worker agents
- 🧠 Neural Networks: 27+ cognitive models with WASM SIMD acceleration
- 🔧 87 MCP Tools: Comprehensive toolkit for swarm orchestration, memory, and automation
- 🔄 Dynamic Agent Architecture (DAA): Self-organizing agents with fault tolerance
- 💾 SQLite Memory System: Persistent
.swarm/memory.db
with 12 specialized tables - 🪝 Advanced Hooks System: Automated workflows with pre/post operation hooks
- 📊 GitHub Integration: 6 specialized modes for repository management
- ⚡ Performance: 84.8% SWE-Bench solve rate, 2.8-4.4x speed improvement
🔥 Revolutionary AI Coordination: Build faster, smarter, and more efficiently with AI-powered development orchestration
# 1. Install Claude Code globally
npm install -g @anthropic-ai/claude-code
# 2. Activate Claude Code with permissions
claude --dangerously-skip-permissions
# 1. Initialize Claude Flow with enhanced MCP setup (auto-configures permissions!)
npx --y claude-flow@alpha init --force
# 2. Explore all revolutionary capabilities
npx --y claude-flow@alpha --help
# 3. Launch the interactive hive-mind wizard
npx --y claude-flow@alpha hive-mind wizard
# 4. Build something amazing with AI coordination
npx claude-flow@alpha hive-mind spawn "build me something amazing" --claude
Confused about .hive-mind
and .swarm
directories? Not sure when to create new hives? Here are the most common workflow patterns:
# Initialize once per feature/task
npx claude-flow@alpha init --force
npx claude-flow@alpha hive-mind spawn "Implement user authentication" --claude
# Continue working on SAME feature (reuse existing hive)
npx claude-flow@alpha hive-mind status
npx claude-flow@alpha memory query "authentication" --recent
npx claude-flow@alpha swarm "Add password reset functionality" --continue-session
# Project-level initialization (once per project)
npx claude-flow@alpha init --force --project-name "my-app"
# Feature 1: Authentication (new hive)
npx claude-flow@alpha hive-mind spawn "auth-system" --namespace auth --claude
# Feature 2: User management (separate hive)
npx claude-flow@alpha hive-mind spawn "user-management" --namespace users --claude
# Resume Feature 1 later
npx claude-flow@alpha hive-mind resume --namespace auth
# Start research session
npx claude-flow@alpha hive-mind spawn "Research microservices patterns" --agents researcher,analyst --claude
# Continue research in SAME session
npx claude-flow@alpha memory stats # See what's been learned
npx claude-flow@alpha swarm "Deep dive into API gateway patterns" --continue-session
Situation | Action | Command |
---|---|---|
Same objective/feature | Continue existing hive | npx claude-flow@alpha hive-mind resume |
New feature in same project | Create new hive with namespace | npx claude-flow@alpha hive-mind spawn "new-feature" --namespace feature-name |
Completely different project | New directory + init | mkdir new-project && cd new-project && npx claude-flow@alpha init |
Experimenting/testing | Temporary hive | npx claude-flow@alpha hive-mind spawn "experiment" --temp |
Don't panic if directories seem empty! Claude-Flow uses SQLite databases that may not show files in directory listings:
# Check what's actually stored (even if directories look empty)
npx claude-flow@alpha memory stats # See memory data
npx claude-flow@alpha memory list # List all namespaces
npx claude-flow@alpha hive-mind status # See active hives
# Your project structure after initialization:
# .hive-mind/ <- Contains config.json + SQLite session data
# .swarm/ <- Contains memory.db (SQLite database)
# memory/ <- Agent-specific memories (created when agents spawn)
# coordination/ <- Active workflow files (created during tasks)
# See what you were working on
npx claude-flow@alpha hive-mind status
npx claude-flow@alpha memory query --recent --limit 5
# Resume the most recent hive
npx claude-flow@alpha hive-mind resume
# Or resume specific namespace
npx claude-flow@alpha hive-mind resume --namespace auth
Claude-Flow v2.0.0 introduces a powerful hooks system that automates coordination and enhances every operation:
# Hooks automatically trigger on operations
npx claude-flow@alpha init --force # Auto-configures MCP servers & hooks
pre-task
: Auto-assigns agents based on task complexitypre-search
: Caches searches for improved performancepre-edit
: Validates files and prepares resourcespre-command
: Security validation before execution
post-edit
: Auto-formats code using language-specific toolspost-task
: Trains neural patterns from successful operationspost-command
: Updates memory with operation contextnotification
: Real-time progress updates
session-start
: Restores previous context automaticallysession-end
: Generates summaries and persists statesession-restore
: Loads memory from previous sessions
// .claude/settings.json (auto-configured)
{
"hooks": {
"preEditHook": {
"command": "npx",
"args": ["claude-flow", "hooks", "pre-edit", "--file", "${file}", "--auto-assign-agents", "true"],
"alwaysRun": false
},
"postEditHook": {
"command": "npx",
"args": ["claude-flow", "hooks", "post-edit", "--file", "${file}", "--format", "true"],
"alwaysRun": true
},
"sessionEndHook": {
"command": "npx",
"args": ["claude-flow", "hooks", "session-end", "--generate-summary", "true"],
"alwaysRun": true
}
}
}
Hooks integrate seamlessly with Claude Code's workflow:
- Automatic Triggering: Hooks fire automatically during Claude Code operations
- Context Awareness: Each hook receives relevant context (file paths, commands, etc.)
- Non-Blocking: Hooks run asynchronously to maintain performance
- Configurable: Enable/disable specific hooks as needed
# Manual hook execution
npx claude-flow hooks pre-task --description "Build REST API" --auto-spawn-agents
# Post-edit with formatting
npx claude-flow hooks post-edit --file "src/api.js" --format --train-neural
# Session management
npx claude-flow hooks session-end --generate-summary --persist-state
Claude-Flow v2.0.0 introduces groundbreaking hive-mind architecture where a Queen AI coordinates specialized worker agents in perfect harmony.
# Deploy intelligent swarm coordination
npx claude-flow@alpha swarm "Build a full-stack application" --strategy development --claude
# Launch hive-mind with specific specializations
npx claude-flow@alpha hive-mind spawn "Create microservices architecture" --agents 8 --claude
- 👑 Queen Agent: Master coordinator and decision maker
- 🏗️ Architect Agents: System design and technical architecture
- 💻 Coder Agents: Implementation and development
- 🧪 Tester Agents: Quality assurance and validation
- 📊 Analyst Agents: Data analysis and insights
- 🔍 Researcher Agents: Information gathering and analysis
- 🛡️ Security Agents: Security auditing and compliance
- 🚀 DevOps Agents: Deployment and infrastructure
# Neural pattern recognition and training
npx claude-flow@alpha neural train --pattern coordination --epochs 50
npx claude-flow@alpha neural predict --model cognitive-analysis
npx claude-flow@alpha cognitive analyze --behavior "development workflow"
# Cross-session memory management with SQLite persistence
npx claude-flow@alpha memory store "project-context" "Full-stack app requirements"
npx claude-flow@alpha memory query "authentication" --namespace sparc
npx claude-flow@alpha memory stats # Shows 12 specialized tables
npx claude-flow@alpha memory export backup.json --namespace default
npx claude-flow@alpha memory import project-memory.json
# Advanced workflow automation
npx claude-flow@alpha workflow create --name "CI/CD Pipeline" --parallel
npx claude-flow@alpha batch process --items "test,build,deploy" --concurrent
npx claude-flow@alpha pipeline create --config advanced-deployment.json
Powered by 27+ neural models optimized with WASM SIMD acceleration:
# Train coordination patterns
npx claude-flow@alpha neural train --pattern coordination --data "workflow.json"
# Real-time predictions
npx claude-flow@alpha neural predict --model task-optimizer --input "current-state.json"
# Analyze cognitive behavior
npx claude-flow@alpha cognitive analyze --behavior "development-patterns"
- Pattern Recognition: Learns from successful operations
- Adaptive Learning: Improves performance over time
- Transfer Learning: Apply knowledge across domains
- Model Compression: Efficient storage and execution
- Ensemble Models: Combine multiple neural networks
- Explainable AI: Understand decision-making process
Complete programmatic control over agent lifecycle and coordination:
# Create specialized agents
npx claude-flow@alpha daa agent-create --type "specialized-researcher" \
--capabilities "[\"deep-analysis\", \"pattern-recognition\"]" \
--resources "{\"memory\": 2048, \"compute\": \"high\"}"
# Match capabilities to tasks
npx claude-flow@alpha daa capability-match \
--task-requirements "[\"security-analysis\", \"performance-optimization\"]"
# Manage agent lifecycle
npx claude-flow@alpha daa lifecycle-manage --agentId "agent-123" --action "scale-up"
- Resource Allocation: Dynamic CPU/memory management
- Inter-Agent Communication: Message passing and coordination
- Consensus Mechanisms: Democratic decision making
- Fault Tolerance: Self-healing with automatic recovery
- Performance Optimization: Real-time bottleneck resolution
swarm_init
,agent_spawn
,task_orchestrate
swarm_monitor
,topology_optimize
,load_balance
coordination_sync
,swarm_scale
,swarm_destroy
neural_train
,neural_predict
,pattern_recognize
cognitive_analyze
,learning_adapt
,neural_compress
ensemble_create
,transfer_learn
,neural_explain
memory_usage
,memory_search
,memory_persist
memory_namespace
,memory_backup
,memory_restore
memory_compress
,memory_sync
,memory_analytics
- SQLite Backend: Persistent
.swarm/memory.db
with 12 specialized tables
performance_report
,bottleneck_analyze
,token_usage
benchmark_run
,metrics_collect
,trend_analysis
health_check
,diagnostic_run
,usage_stats
workflow_create
,workflow_execute
,workflow_export
automation_setup
,pipeline_create
,scheduler_manage
trigger_setup
,batch_process
,parallel_execute
github_repo_analyze
,github_pr_manage
,github_issue_track
github_release_coord
,github_workflow_auto
,github_code_review
daa_agent_create
,daa_capability_match
,daa_resource_alloc
daa_lifecycle_manage
,daa_communication
,daa_consensus
security_scan
,backup_create
,restore_system
config_manage
,features_detect
,log_analysis
Claude-Flow v2.0.0 introduces groundbreaking hive-mind architecture where a Queen AI coordinates specialized worker agents in perfect harmony.
# Deploy intelligent swarm coordination
npx claude-flow@alpha swarm "Build a full-stack application" --strategy development --claude
# Launch hive-mind with specific specializations
npx claude-flow@alpha hive-mind spawn "Create microservices architecture" --agents 8 --claude
- 👑 Queen Agent: Master coordinator and decision maker
- 🏗️ Architect Agents: System design and technical architecture
- 💻 Coder Agents: Implementation and development
- 🧪 Tester Agents: Quality assurance and validation
- 📊 Analyst Agents: Data analysis and insights
- 🔍 Researcher Agents: Information gathering and analysis
- 🛡️ Security Agents: Security auditing and compliance
- 🚀 DevOps Agents: Deployment and infrastructure
# Neural pattern recognition and training
npx claude-flow@alpha neural train --pattern coordination --epochs 50
npx claude-flow@alpha neural predict --model cognitive-analysis
npx claude-flow@alpha cognitive analyze --behavior "development workflow"
# Cross-session memory management with SQLite persistence
npx claude-flow@alpha memory store "project-context" "Full-stack app requirements"
npx claude-flow@alpha memory query "authentication" --namespace sparc
npx claude-flow@alpha memory stats # Shows 12 specialized tables
npx claude-flow@alpha memory export backup.json --namespace default
npx claude-flow@alpha memory import project-memory.json
# Advanced workflow automation
npx claude-flow@alpha workflow create --name "CI/CD Pipeline" --parallel
npx claude-flow@alpha batch process --items "test,build,deploy" --concurrent
npx claude-flow@alpha pipeline create --config advanced-deployment.json
# GitHub workflow orchestration and coordination
npx claude-flow@alpha github gh-coordinator analyze --analysis-type security
npx claude-flow@alpha github pr-manager review --multi-reviewer --ai-powered
npx claude-flow@alpha github release-manager coord --version 2.0.0 --auto-changelog
npx claude-flow@alpha github repo-architect optimize --structure-analysis
npx claude-flow@alpha github issue-tracker manage --project-coordination
npx claude-flow@alpha github sync-coordinator align --multi-package
v2.0.0 Alpha automatically configures MCP servers for seamless Claude Code integration:
# Automatic MCP integration (happens during init)
✅ claude-flow MCP server configured
✅ ruv-swarm MCP server configured
✅ 87 tools available in Claude Code
✅ --dangerously-skip-permissions set as default
# Advanced SPARC development with neural enhancement
npx claude-flow@alpha sparc mode --type "neural-tdd" --auto-learn
npx claude-flow@alpha sparc workflow --phases "all" --ai-guided --memory-enhanced
- 27+ Cognitive Models: Adaptive learning from successful operations
- Pattern Analysis: Real-time behavior analysis and optimization
- Decision Tracking: Complete audit trail of AI decisions
- Performance Learning: Continuous improvement from past executions
# Automatic error recovery and optimization
npx claude-flow@alpha health check --components all --auto-heal
npx claude-flow@alpha fault tolerance --strategy retry-with-learning
npx claude-flow@alpha bottleneck analyze --auto-optimize
- SQLite Persistence: Robust
.swarm/memory.db
storage with 12 specialized tables - Cross-Session Persistence: Remember context across Claude Code sessions
- Namespace Management: Organized memory with hierarchical access
- Enhanced Schema: Agent interactions, training data, performance metrics, and more
- Memory Compression: Efficient storage of large coordination contexts
- Distributed Sync: Share memory across multiple AI instances
- ✅ 84.8% SWE-Bench Solve Rate: Superior problem-solving through hive-mind coordination
- ✅ 32.3% Token Reduction: Efficient task breakdown reduces costs significantly
- ✅ 2.8-4.4x Speed Improvement: Parallel coordination maximizes throughput
- ✅ 87 MCP Tools: Most comprehensive AI tool suite available
- ✅ Zero-Config Setup: Automatic MCP integration with Claude Code
# Check memory system performance
npx claude-flow@alpha memory stats
npx claude-flow@alpha memory list
# Test GitHub coordination modes
npx claude-flow@alpha github gh-coordinator --help
npx claude-flow@alpha github pr-manager --help
# Workflow orchestration
npx claude-flow@alpha workflow create --name "Development Pipeline" --parallel
# Deploy complete development swarm
npx claude-flow@alpha hive-mind spawn "Build e-commerce platform with React, Node.js, and PostgreSQL" \
--agents 10 \
--strategy parallel \
--memory-namespace ecommerce \
--claude
# Monitor progress in real-time
npx claude-flow@alpha swarm monitor --dashboard --real-time
# Deploy research swarm with neural enhancement
npx claude-flow@alpha swarm "Research AI safety in autonomous systems" \
--strategy research \
--neural-patterns enabled \
--memory-compression high \
--claude
# Analyze results with cognitive computing
npx claude-flow@alpha cognitive analyze --target research-results
# Automated security analysis with AI coordination
npx claude-flow@alpha github gh-coordinator analyze --analysis-type security --target ./src
npx claude-flow@alpha github repo-architect optimize --security-focused --compliance SOC2
npx claude-flow@alpha hive-mind spawn "security audit and compliance review" --claude
┌─────────────────────────────────────────────────────────┐
│ 👑 Queen Agent │
│ (Master Coordinator) │
├─────────────────────────────────────────────────────────┤
│ 🏗️ Architect │ 💻 Coder │ 🧪 Tester │ 🔍 Research │ 🛡️ Security │
│ Agent │ Agent │ Agent │ Agent │ Agent │
├─────────────────────────────────────────────────────────┤
│ 🧠 Neural Pattern Recognition Layer │
├─────────────────────────────────────────────────────────┤
│ 💾 Distributed Memory System │
├─────────────────────────────────────────────────────────┤
│ ⚡ 87 MCP Tools Integration Layer │
├─────────────────────────────────────────────────────────┤
│ 🛡️ Claude Code Integration │
└─────────────────────────────────────────────────────────┘
- Hierarchical: Queen-led with specialized worker agents
- Mesh: Peer-to-peer coordination for complex tasks
- Hybrid: Dynamic strategy selection based on task complexity
- Neural-Enhanced: AI-optimized coordination patterns
# Global installation (recommended for testing)
npm install -g claude-flow@alpha
# Or use NPX for instant testing
npx claude-flow@alpha init --force
# Verify installation
claude-flow --version # Should show 2.0.0-alpha.x
# Initialize with full alpha features
npx claude-flow@alpha init --force --hive-mind --neural-enhanced
# Configure Claude Code integration
npx claude-flow@alpha mcp setup --auto-permissions --87-tools
# Test hive-mind coordination
npx claude-flow@alpha hive-mind test --agents 5 --coordination-test
Command | Description | Example |
---|---|---|
hive-mind wizard |
Interactive hive setup | npx claude-flow@alpha hive-mind wizard |
hive-mind spawn |
Deploy intelligent swarm | npx claude-flow@alpha hive-mind spawn "task" --claude |
hive-mind status |
Monitor coordination | npx claude-flow@alpha hive-mind status --real-time |
Command | Description | Example |
---|---|---|
neural train |
Train coordination patterns | npx claude-flow@alpha neural train --pattern optimization |
neural predict |
AI-powered predictions | npx claude-flow@alpha neural predict --model performance |
cognitive analyze |
Behavior analysis | npx claude-flow@alpha cognitive analyze --workflow dev |
Command | Description | Example |
---|---|---|
memory store |
Store key-value pair | npx claude-flow@alpha memory store "context" "data" |
memory query |
Search memory entries | npx claude-flow@alpha memory query "auth" --namespace sparc |
memory stats |
Show memory statistics | npx claude-flow@alpha memory stats |
memory export |
Export memory to file | npx claude-flow@alpha memory export backup.json |
memory import |
Import memory from file | npx claude-flow@alpha memory import project.json |
memory list |
List all namespaces | npx claude-flow@alpha memory list |
Command | Description | Example |
---|---|---|
memory stats |
Memory usage statistics | npx claude-flow@alpha memory stats |
workflow create |
Create workflow pipelines | npx claude-flow@alpha workflow create --name "CI/CD" |
github <mode> |
GitHub coordination modes | npx claude-flow@alpha github gh-coordinator |
Found issues with the alpha? We want to hear from you!
- 🐛 Report Bugs: GitHub Issues
- 💡 Feature Requests: Use the "Alpha Feedback" label
- 🛠️ Development: Check the
claude-flow-v2.0.0
branch - 📋 Alpha Testing: Join our alpha testing program
# Test available GitHub modes
npx claude-flow@alpha github gh-coordinator --help
npx claude-flow@alpha github pr-manager --help
npx claude-flow@alpha github issue-tracker --help
npx claude-flow@alpha github release-manager --help
npx claude-flow@alpha github repo-architect --help
npx claude-flow@alpha github sync-coordinator --help
# Test memory functionality
npx claude-flow@alpha memory stats
npx claude-flow@alpha memory store "test" "alpha testing data"
npx claude-flow@alpha memory query "test"
# Test workflow execution
npx claude-flow@alpha workflow create --name "Test Pipeline" --parallel
# Check memory usage and statistics
npx claude-flow@alpha memory stats
# View available GitHub coordination modes
npx claude-flow@alpha github --help
# Test workflow capabilities
npx claude-flow@alpha workflow --help
- ✅ Hive-mind coordination system
- ✅ 87 MCP tools integration
- ✅ Neural pattern recognition
- ✅ Distributed memory architecture
- ✅ Auto-MCP setup for Claude Code
- 🔜 Enhanced swarm intelligence algorithms
- 🔜 Advanced cognitive computing features
- 🔜 Enterprise security and compliance
- 🔜 Multi-cloud deployment automation
- 🔜 Real-time collaboration features
- 🎯 Production-ready hive-mind orchestration
- 🎯 Complete neural computing suite
- 🎯 Enterprise-grade security and monitoring
- 🎯 Comprehensive documentation and tutorials
- 🎯 Professional support and training
# Clone the alpha development branch
git clone https://github.com/ruvnet/claude-flow.git
cd claude-flow
git checkout claude-flow-v2.0.0
# Install alpha dependencies
npm install
# Build alpha version
npm run build:alpha
# Test alpha features
npm run test:alpha
- Focus on hive-mind coordination testing
- Test neural pattern recognition accuracy
- Validate memory system persistence
- Verify Claude Code MCP integration
- Report performance metrics and bottlenecks
Claude-Flow v2.0.0 introduces revolutionary safety features that ensure secure, reliable AI orchestration at scale:
# Automatic settings.local.json creation during init
# Pre-approves trusted MCP tools - no more permission prompts!
{
"permissions": {
"allow": [
"mcp__ruv-swarm",
"mcp__claude-flow"
],
"deny": []
}
}
- QuDag Networks: Future-proof encryption for global communications
- Byzantine Fault Tolerance: Consensus protocols prevent malicious agents
- Zero-Trust Agent Communication: Every inter-agent message is validated
- Encrypted Memory Storage: Cross-session persistence with AES-256 encryption
# Pre-execution safety checks
npx claude-flow hooks pre-command --validate-security
npx claude-flow hooks pre-edit --check-permissions
- Each agent runs in isolated context
- Resource limits prevent runaway processes
- Automatic timeout on long-running operations
- Memory usage caps per agent
# Complete audit logging
npx claude-flow security audit --full-trace
npx claude-flow security compliance --standard SOC2
- Pattern recognition for anomalous behavior
- Automatic agent suspension on security violations
- Neural network-based threat prediction
- Self-healing security responses
- End-to-end encryption for all agent communications
- <1ms latency with full encryption
- Secure WebSocket connections with TLS 1.3
- Certificate pinning for MCP servers
# Secure agent creation with resource limits
npx claude-flow daa agent-create \
--security-level high \
--resource-limits "cpu:50%,memory:2GB" \
--sandbox enabled
- Code Injection Prevention: Sanitizes all inputs
- Path Traversal Protection: Validates file operations
- Command Injection Blocking: Secure command execution
- Memory Overflow Protection: Prevents buffer attacks
# Instant rollback on security issues
npx claude-flow init --rollback --security-breach
npx claude-flow recovery --point last-safe-state
# Real-time security monitoring
npx claude-flow security monitor --dashboard
npx claude-flow security scan --deep --report
# Security metrics and alerts
npx claude-flow security metrics --last-24h
npx claude-flow security alerts --configure
// .claude/security.json
{
"policies": {
"agent_isolation": true,
"memory_encryption": true,
"audit_logging": "verbose",
"threat_detection": "neural",
"max_agent_resources": {
"cpu": "50%",
"memory": "2GB",
"disk": "10GB"
}
}
}
┌─────────────────────────────────────────────────────────┐
│ 🔐 Security Gateway │
├─────────────────────────────────────────────────────────┤
│ 🛡️ Hook Validation │ 🔒 Permission Layer │
├─────────────────────────────────────────────────────────┤
│ 🚨 Threat Detection & Response │
├─────────────────────────────────────────────────────────┤
│ 🔐 Encrypted Communication │ 📊 Audit Logging │
├─────────────────────────────────────────────────────────┤
│ 🐝 Isolated Agent Sandboxes │
└─────────────────────────────────────────────────────────┘
- Regular security scans with
npx claude-flow security scan
- Enable audit logging for production environments
- Use high security level for sensitive operations
- Configure resource limits for all agents
- Regular backup and recovery testing
MIT License - see LICENSE for details.
Alpha Disclaimer: This is an alpha release intended for testing and feedback. Use in production environments is not recommended.
- 🧠 Hive-Mind Architecture: Inspired by natural swarm intelligence
- ⚡ Neural Computing: Advanced AI coordination patterns
- 🛡️ Claude Code Integration: Seamless AI development workflow
- 🚀 Performance Optimization: 2.8-4.4x speed improvements through parallel coordination
npx --y claude-flow@alpha init --force
Join the alpha testing revolution!
Built with ❤️ by rUv | Powered by Revolutionary AI
v2.0.0 Alpha - The Future of AI Orchestration