claude-flow
Advanced tools
Enterprise-grade AI agent orchestration with ruv-swarm integration (Alpha Release)
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.
.swarm/memory.db with 12 specialized tables🔥 Revolutionary AI Coordination: Build faster, smarter, and more efficiently with AI-powered development orchestration
⚠️ IMPORTANT: Claude Code must be installed first:
# 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 claude-flow@alpha init --force
# 2. Explore all revolutionary capabilities
npx claude-flow@alpha --help
# 3. Launch the interactive hive-mind wizard
npx 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 (use session ID from spawn output)
npx claude-flow@alpha hive-mind resume session-xxxxx-xxxxx
# 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 <session-id> |
| 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
# List all sessions to find the one you want
npx claude-flow@alpha hive-mind sessions
# Resume specific session by ID
npx claude-flow@alpha hive-mind resume session-xxxxx-xxxxx
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 executionpost-edit: Auto-formats code using language-specific toolspost-task: Trains neural patterns from successful operationspost-command: Updates memory with operation contextnotification: Real-time progress updatessession-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:
# 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
# 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"
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"
swarm_init, agent_spawn, task_orchestrateswarm_monitor, topology_optimize, load_balancecoordination_sync, swarm_scale, swarm_destroyneural_train, neural_predict, pattern_recognizecognitive_analyze, learning_adapt, neural_compressensemble_create, transfer_learn, neural_explainmemory_usage, memory_search, memory_persistmemory_namespace, memory_backup, memory_restorememory_compress, memory_sync, memory_analytics.swarm/memory.db with 12 specialized tablesperformance_report, bottleneck_analyze, token_usagebenchmark_run, metrics_collect, trend_analysishealth_check, diagnostic_run, usage_statsworkflow_create, workflow_execute, workflow_exportautomation_setup, pipeline_create, scheduler_managetrigger_setup, batch_process, parallel_executegithub_repo_analyze, github_pr_manage, github_issue_trackgithub_release_coord, github_workflow_auto, github_code_reviewdaa_agent_create, daa_capability_match, daa_resource_allocdaa_lifecycle_manage, daa_communication, daa_consensussecurity_scan, backup_create, restore_system
config_manage, features_detect, log_analysis
# 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
# 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
.swarm/memory.db storage with 12 specialized tables# 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 │
└─────────────────────────────────────────────────────────┘
# 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!
claude-flow-v2.0.0 branch# 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
# 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
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": []
}
}
# Pre-execution safety checks
npx claude-flow hooks pre-command --validate-security
npx claude-flow hooks pre-edit --check-permissions
# Complete audit logging
npx claude-flow security audit --full-trace
npx claude-flow security compliance --standard SOC2
# Secure agent creation with resource limits
npx claude-flow daa agent-create \
--security-level high \
--resource-limits "cpu:50%,memory:2GB" \
--sandbox enabled
# 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 │
└─────────────────────────────────────────────────────────┘
npx claude-flow security scanMIT License - see LICENSE for details.
Alpha Disclaimer: This is an alpha release intended for testing and feedback. Use in production environments is not recommended.
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
FAQs
Enterprise-grade AI agent orchestration with ruv-swarm integration (Alpha Release)
The npm package claude-flow receives a total of 5,235 weekly downloads. As such, claude-flow popularity was classified as popular.
We found that claude-flow demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Popular npm packages like eslint-config-prettier were compromised after a phishing attack stole a maintainer’s token, spreading malicious updates.
Security News
/Research
A phishing attack targeted developers using a typosquatted npm domain (npnjs.com) to steal credentials via fake login pages - watch out for similar scams.
Security News
Knip hits 500 releases with v5.62.0, refining TypeScript config detection and updating plugins as monthly npm downloads approach 12M.
