{"id":29432106,"url":"https://github.com/ruvnet/claude-flow","last_synced_at":"2025-08-06T21:18:10.181Z","repository":{"id":298234495,"uuid":"995029641","full_name":"ruvnet/claude-flow","owner":"ruvnet","description":"Claude-Flow v2.0.0 Alpha represents a leap in AI-powered development orchestration. Built from the ground up with enterprise-grade architecture, advanced swarm intelligence, and seamless Claude Code integration.","archived":false,"fork":false,"pushed_at":"2025-08-05T20:48:36.000Z","size":317549,"stargazers_count":5271,"open_issues_count":123,"forks_count":719,"subscribers_count":82,"default_branch":"main","last_synced_at":"2025-08-05T21:05:49.445Z","etag":null,"topics":["claude-code","neural-networks","swarm"],"latest_commit_sha":null,"homepage":"https://discord.com/invite/dfxmpwkG2D","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ruvnet.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-02T21:24:20.000Z","updated_at":"2025-08-05T21:01:12.000Z","dependencies_parsed_at":"2025-07-29T17:24:48.205Z","dependency_job_id":null,"html_url":"https://github.com/ruvnet/claude-flow","commit_stats":null,"previous_names":["ruvnet/claude-code-flow","ruvnet/claude-flow"],"tags_count":623,"template":false,"template_full_name":null,"purl":"pkg:github/ruvnet/claude-flow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fclaude-flow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fclaude-flow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fclaude-flow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fclaude-flow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ruvnet","download_url":"https://codeload.github.com/ruvnet/claude-flow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fclaude-flow/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269158380,"owners_count":24370012,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-06T02:00:09.910Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","neural-networks","swarm"],"created_at":"2025-07-12T22:01:08.367Z","updated_at":"2025-08-06T21:18:10.171Z","avatar_url":"https://github.com/ruvnet.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","AI开源项目","📚 Projects (1974 total)","Agent Integration \u0026 Deployment Tools","JavaScript","Agents \u0026 Agent Managers","🎯 Project Management \u0026 Orchestration","HarmonyOS","カテゴリ","A01_文本生成_文本对话","Repos","AI Coding Agents","AI \u0026 ML (18)","Agent Orchestration","框架扩展","Multi-Agent \u0026 Orchestration","Multi-Agent Swarms","Harnesses \u0026 orchestration","Orchestration Frameworks","Framework"],"sub_categories":["AI Agent","MCP Servers","AI Agent Orchestration","📖 Community Guides \u0026 Tutorials","Windows Manager","🛠️ \u003ca name=\"developer-tools\"\u003e\u003c/a\u003e開発ツール","大语言对话模型及数据","Claude Code","Other IDEs","Orchestrators \u0026 autonomous loops"],"readme":"# 🌊 Claude-Flow v2.0.0 Alpha: Revolutionary AI Orchestration Platform\n\n\u003cdiv align=\"center\"\u003e\n\n[![🌟 Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge\u0026logo=github\u0026color=gold)](https://github.com/ruvnet/claude-flow)\n[![📦 Alpha Release](https://img.shields.io/npm/v/claude-flow/alpha?style=for-the-badge\u0026logo=npm\u0026color=orange\u0026label=v2.0.0-alpha.53)](https://www.npmjs.com/package/claude-flow/v/alpha)\n[![⚡ Claude Code](https://img.shields.io/badge/Claude%20Code-Optimized-green?style=for-the-badge\u0026logo=anthropic)](https://github.com/ruvnet/claude-flow)\n[![🏛️ Agentics Foundation](https://img.shields.io/badge/Agentics-Foundation-crimson?style=for-the-badge\u0026logo=openai)](https://discord.com/invite/dfxmpwkG2D)\n[![🐝 Hive-Mind](https://img.shields.io/badge/Hive--Mind-AI%20Coordination-purple?style=for-the-badge\u0026logo=swarm)](https://github.com/ruvnet/claude-flow)\n[![🧠 Neural](https://img.shields.io/badge/Neural-87%20MCP%20Tools-blue?style=for-the-badge\u0026logo=tensorflow)](https://github.com/ruvnet/claude-flow)\n[![🛡️ MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge\u0026logo=opensourceinitiative)](https://opensource.org/licenses/MIT)\n\n\u003c/div\u003e\n\n---\n\n## 🌟 **Overview**\n\n**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.\n\n### 🎯 **Key Features**\n\n- **🐝 Hive-Mind Intelligence**: Queen-led AI coordination with specialized worker agents\n- **🧠 Neural Networks**: 27+ cognitive models with WASM SIMD acceleration\n- **🔧 87 MCP Tools**: Comprehensive toolkit for swarm orchestration, memory, and automation\n- **🔄 Dynamic Agent Architecture (DAA)**: Self-organizing agents with fault tolerance\n- **💾 SQLite Memory System**: Persistent `.swarm/memory.db` with 12 specialized tables\n- **🪝 Advanced Hooks System**: Automated workflows with pre/post operation hooks\n- **📊 GitHub Integration**: 6 specialized modes for repository management\n- **⚡ Performance**: 84.8% SWE-Bench solve rate, 2.8-4.4x speed improvement\n\n\u003e 🔥 **Revolutionary AI Coordination**: Build faster, smarter, and more efficiently with AI-powered development orchestration\n\n## ⚡ **Try v2.0.0 Alpha in 4 Commands**\n\n### 📋 **Prerequisites**\n\n- **Node.js 18+** (LTS recommended)\n- **npm 9+** or equivalent package manager\n- **Windows users**: See [Windows Installation Guide](https://github.com/ruvnet/claude-code-flow/blob/main/docs/windows-installation.md) for special instructions\n\n⚠️ **IMPORTANT**: Claude Code must be installed first:\n\n```bash\n# 1. Install Claude Code globally\nnpm install -g @anthropic-ai/claude-code\n\n# 2. (Optional) Skip permissions check for faster setup\n# Only use if you understand the security implications\n# claude --dangerously-skip-permissions\n```\n\n💡 **Windows Note**: If you encounter SQLite errors, Claude Flow will automatically use in-memory storage. For persistent storage options, see our [Windows guide](https://github.com/ruvnet/claude-code-flow/blob/main/docs/windows-installation.md).\n\n### 🎯 **Instant Alpha Testing**\n\n```bash\n# 1. Initialize Claude Flow with enhanced MCP setup (auto-configures permissions!)\nnpx claude-flow@alpha init --force\n\n# 2. Explore all revolutionary capabilities  \nnpx claude-flow@alpha --help\n\n# 3a. Quick AI coordination (recommended for most tasks)\nnpx claude-flow@alpha swarm \"build me a REST API\"\n\n# 3b. OR launch the full hive-mind system (for complex projects)\nnpx claude-flow@alpha hive-mind wizard\nnpx claude-flow@alpha hive-mind spawn \"build enterprise system\" --claude\n```\n\n### 🤔 **Swarm vs Hive-Mind: Which to Use?**\n\n| Feature | `swarm` Command | `hive-mind` Command |\n|---------|----------------|-------------------|\n| **Best For** | Quick tasks, single objectives | Complex projects, persistent sessions |\n| **Setup** | Instant - no configuration needed | Interactive wizard setup |\n| **Session** | Temporary coordination | Persistent with resume capability |\n| **Memory** | Task-scoped | Project-wide with SQLite storage |\n| **Agents** | Auto-spawned for task | Manual control with specializations |\n| **Use When** | \"Build X\", \"Fix Y\", \"Analyze Z\" | Multi-feature projects, team coordination |\n\n**Quick Rule:** Start with `swarm` for most tasks. Use `hive-mind` when you need persistent sessions or complex multi-agent coordination.\n\n## 🎯 **Typical Workflows - Your \"Happy Path\" Guide**\n\n### **New to Claude-Flow? Start Here!**\n\nConfused about `.hive-mind` and `.swarm` directories? Not sure when to create new hives? Here are the most common workflow patterns:\n\n#### **🚀 Pattern 1: Single Feature Development**\n```bash\n# Initialize once per feature/task\nnpx claude-flow@alpha init --force\nnpx claude-flow@alpha hive-mind spawn \"Implement user authentication\" --claude\n\n# Continue working on SAME feature (reuse existing hive)\nnpx claude-flow@alpha hive-mind status\nnpx claude-flow@alpha memory query \"authentication\" --recent\nnpx claude-flow@alpha swarm \"Add password reset functionality\" --continue-session\n```\n\n#### **🏗️ Pattern 2: Multi-Feature Project**\n```bash\n# Project-level initialization (once per project)\nnpx claude-flow@alpha init --force --project-name \"my-app\"\n\n# Feature 1: Authentication (new hive)\nnpx claude-flow@alpha hive-mind spawn \"auth-system\" --namespace auth --claude\n\n# Feature 2: User management (separate hive)  \nnpx claude-flow@alpha hive-mind spawn \"user-management\" --namespace users --claude\n\n# Resume Feature 1 later (use session ID from spawn output)\nnpx claude-flow@alpha hive-mind resume session-xxxxx-xxxxx\n```\n\n#### **🔍 Pattern 3: Research \u0026 Analysis**\n```bash\n# Start research session\nnpx claude-flow@alpha hive-mind spawn \"Research microservices patterns\" --agents researcher,analyst --claude\n\n# Continue research in SAME session\nnpx claude-flow@alpha memory stats  # See what's been learned\nnpx claude-flow@alpha swarm \"Deep dive into API gateway patterns\" --continue-session\n```\n\n### **🤔 When Should I Create a New Hive?**\n\n| Situation | Action | Command |\n|-----------|--------|---------|\n| **Same objective/feature** | Continue existing hive | `npx claude-flow@alpha hive-mind resume \u003csession-id\u003e` |\n| **New feature in same project** | Create new hive with namespace | `npx claude-flow@alpha hive-mind spawn \"new-feature\" --namespace feature-name` |\n| **Completely different project** | New directory + init | `mkdir new-project \u0026\u0026 cd new-project \u0026\u0026 npx claude-flow@alpha init` |\n| **Experimenting/testing** | Temporary hive | `npx claude-flow@alpha hive-mind spawn \"experiment\" --temp` |\n\n### **📁 Understanding \"Empty\" Directories**\n\n**Don't panic if directories seem empty!** Claude-Flow uses SQLite databases that may not show files in directory listings:\n\n```bash\n# Check what's actually stored (even if directories look empty)\nnpx claude-flow@alpha memory stats        # See memory data\nnpx claude-flow@alpha memory list         # List all namespaces  \nnpx claude-flow@alpha hive-mind status    # See active hives\n\n# Your project structure after initialization:\n# .hive-mind/     \u003c- Contains config.json + SQLite session data\n# .swarm/         \u003c- Contains memory.db (SQLite database)\n# memory/         \u003c- Agent-specific memories (created when agents spawn)\n# coordination/   \u003c- Active workflow files (created during tasks)\n```\n\n### **🔄 Continuing Previous Work**\n\n```bash\n# See what you were working on\nnpx claude-flow@alpha hive-mind status\nnpx claude-flow@alpha memory query --recent --limit 5\n\n# List all sessions to find the one you want\nnpx claude-flow@alpha hive-mind sessions\n\n# Resume specific session by ID\nnpx claude-flow@alpha hive-mind resume session-xxxxx-xxxxx\n```\n\n---\n\n## 🪝 **Advanced Hooks System**\n\n### **Automated Workflow Enhancement**\nClaude-Flow v2.0.0 introduces a powerful hooks system that automates coordination and enhances every operation:\n\n```bash\n# Hooks automatically trigger on operations\nnpx claude-flow@alpha init --force  # Auto-configures MCP servers \u0026 hooks\n```\n\n### **Available Hooks**\n\n#### **Pre-Operation Hooks**\n- **`pre-task`**: Auto-assigns agents based on task complexity\n- **`pre-search`**: Caches searches for improved performance  \n- **`pre-edit`**: Validates files and prepares resources\n- **`pre-command`**: Security validation before execution\n\n#### **Post-Operation Hooks**\n- **`post-edit`**: Auto-formats code using language-specific tools\n- **`post-task`**: Trains neural patterns from successful operations\n- **`post-command`**: Updates memory with operation context\n- **`notification`**: Real-time progress updates\n\n#### **Session Hooks**\n- **`session-start`**: Restores previous context automatically\n- **`session-end`**: Generates summaries and persists state\n- **`session-restore`**: Loads memory from previous sessions\n\n### **Hook Configuration**\n```json\n// .claude/settings.json (auto-configured)\n{\n  \"hooks\": {\n    \"preEditHook\": {\n      \"command\": \"npx\",\n      \"args\": [\"claude-flow\", \"hooks\", \"pre-edit\", \"--file\", \"${file}\", \"--auto-assign-agents\", \"true\"],\n      \"alwaysRun\": false\n    },\n    \"postEditHook\": {\n      \"command\": \"npx\", \n      \"args\": [\"claude-flow\", \"hooks\", \"post-edit\", \"--file\", \"${file}\", \"--format\", \"true\"],\n      \"alwaysRun\": true\n    },\n    \"sessionEndHook\": {\n      \"command\": \"npx\",\n      \"args\": [\"claude-flow\", \"hooks\", \"session-end\", \"--generate-summary\", \"true\"],\n      \"alwaysRun\": true\n    }\n  }\n}\n```\n\n### **Using Hooks in Claude Code**\n\nHooks integrate seamlessly with Claude Code's workflow:\n\n1. **Automatic Triggering**: Hooks fire automatically during Claude Code operations\n2. **Context Awareness**: Each hook receives relevant context (file paths, commands, etc.)\n3. **Non-Blocking**: Hooks run asynchronously to maintain performance\n4. **Configurable**: Enable/disable specific hooks as needed\n\n### **Hook Examples**\n\n```bash\n# Manual hook execution\nnpx claude-flow hooks pre-task --description \"Build REST API\" --auto-spawn-agents\n\n# Post-edit with formatting\nnpx claude-flow hooks post-edit --file \"src/api.js\" --format --train-neural\n\n# Session management\nnpx claude-flow hooks session-end --generate-summary --persist-state\n```\n\n### **Fixing Hook Variable Interpolation**\n\nIf you're experiencing issues with `${file}` or `${command}` variables not working in your hooks (common with Claude Code 1.0.51+), use the `fix-hook-variables` command:\n\n```bash\n# Fix all found settings.json files\nnpx claude-flow@alpha fix-hook-variables\n\n# Fix specific file\nnpx claude-flow@alpha fix-hook-variables .claude/settings.json\n\n# Create test configuration\nnpx claude-flow@alpha fix-hook-variables --test\n```\n\nThis command automatically transforms legacy variable syntax to working environment variables:\n- `${file}` → `$CLAUDE_EDITED_FILE`\n- `${command}` → `$CLAUDE_COMMAND`\n- `${tool}` → `$CLAUDE_TOOL`\n\n---\n## 🐝 **Revolutionary Hive-Mind Intelligence**\n\n### **Queen-Led AI Coordination**\nClaude-Flow v2.0.0 introduces groundbreaking hive-mind architecture where a **Queen AI** coordinates specialized worker agents in perfect harmony.\n\n```bash\n# Deploy intelligent swarm coordination\nnpx claude-flow@alpha swarm \"Build a full-stack application\" --strategy development\n\n# Launch hive-mind with specific specializations\nnpx claude-flow@alpha hive-mind spawn \"Create microservices architecture\" --agents 8 --claude\n```\n\n### **🤖 Intelligent Agent Types**\n- **👑 Queen Agent**: Master coordinator and decision maker\n- **🏗️ Architect Agents**: System design and technical architecture\n- **💻 Coder Agents**: Implementation and development\n- **🧪 Tester Agents**: Quality assurance and validation\n- **📊 Analyst Agents**: Data analysis and insights\n- **🔍 Researcher Agents**: Information gathering and analysis\n- **🛡️ Security Agents**: Security auditing and compliance\n- **🚀 DevOps Agents**: Deployment and infrastructure\n\n---\n\n## ⚡ **87 Advanced MCP Tools**\n\n### **🧠 Neural \u0026 Cognitive Tools**\n```bash\n# Neural pattern recognition and training\nnpx claude-flow@alpha neural train --pattern coordination --epochs 50\nnpx claude-flow@alpha neural predict --model cognitive-analysis\nnpx claude-flow@alpha cognitive analyze --behavior \"development workflow\"\n```\n\n### **💾 SQLite Memory Systems**\n```bash\n# Cross-session memory management with SQLite persistence\nnpx claude-flow@alpha memory store \"project-context\" \"Full-stack app requirements\"\nnpx claude-flow@alpha memory query \"authentication\" --namespace sparc\nnpx claude-flow@alpha memory stats  # Shows 12 specialized tables\nnpx claude-flow@alpha memory export backup.json --namespace default\nnpx claude-flow@alpha memory import project-memory.json\n```\n\n\u003e 🪟 **Windows Users**: SQLite will automatically fallback to in-memory storage if native modules fail. All features work normally, but data won't persist between sessions. See [Windows guide](https://github.com/ruvnet/claude-code-flow/blob/main/docs/windows-installation.md) for persistent storage options.\n\n### **🔄 Workflow Orchestration**\n```bash\n# Advanced workflow automation\nnpx claude-flow@alpha workflow create --name \"CI/CD Pipeline\" --parallel\nnpx claude-flow@alpha batch process --items \"test,build,deploy\" --concurrent\nnpx claude-flow@alpha pipeline create --config advanced-deployment.json\n```\n\n## 🧠 **Neural Network Capabilities**\n\n### **Cognitive Computing Engine**\nPowered by 27+ neural models optimized with WASM SIMD acceleration:\n\n```bash\n# Train coordination patterns\nnpx claude-flow@alpha neural train --pattern coordination --data \"workflow.json\"\n\n# Real-time predictions\nnpx claude-flow@alpha neural predict --model task-optimizer --input \"current-state.json\"\n\n# Analyze cognitive behavior\nnpx claude-flow@alpha cognitive analyze --behavior \"development-patterns\"\n```\n\n### **Neural Features**\n- **Pattern Recognition**: Learns from successful operations\n- **Adaptive Learning**: Improves performance over time\n- **Transfer Learning**: Apply knowledge across domains\n- **Model Compression**: Efficient storage and execution\n- **Ensemble Models**: Combine multiple neural networks\n- **Explainable AI**: Understand decision-making process\n\n## 🔧 **DAA MCP Endpoints**\n\n### **Dynamic Agent Architecture**\nComplete programmatic control over agent lifecycle and coordination:\n\n```bash\n# Create specialized agents\nnpx claude-flow@alpha daa agent-create --type \"specialized-researcher\" \\\n  --capabilities \"[\\\"deep-analysis\\\", \\\"pattern-recognition\\\"]\" \\\n  --resources \"{\\\"memory\\\": 2048, \\\"compute\\\": \\\"high\\\"}\"\n\n# Match capabilities to tasks\nnpx claude-flow@alpha daa capability-match \\\n  --task-requirements \"[\\\"security-analysis\\\", \\\"performance-optimization\\\"]\"\n\n# Manage agent lifecycle\nnpx claude-flow@alpha daa lifecycle-manage --agentId \"agent-123\" --action \"scale-up\"\n```\n\n### **DAA Features**\n- **Resource Allocation**: Dynamic CPU/memory management\n- **Inter-Agent Communication**: Message passing and coordination\n- **Consensus Mechanisms**: Democratic decision making\n- **Fault Tolerance**: Self-healing with automatic recovery\n- **Performance Optimization**: Real-time bottleneck resolution\n\n### **MCP Tool Categories**\n\n#### **🐝 Swarm Orchestration** (15 tools)\n- `swarm_init`, `agent_spawn`, `task_orchestrate`\n- `swarm_monitor`, `topology_optimize`, `load_balance`\n- `coordination_sync`, `swarm_scale`, `swarm_destroy`\n\n#### **🧠 Neural \u0026 Cognitive** (12 tools)\n- `neural_train`, `neural_predict`, `pattern_recognize`\n- `cognitive_analyze`, `learning_adapt`, `neural_compress`\n- `ensemble_create`, `transfer_learn`, `neural_explain`\n\n#### **💾 Memory Management** (10 tools)\n- `memory_usage`, `memory_search`, `memory_persist`\n- `memory_namespace`, `memory_backup`, `memory_restore`\n- `memory_compress`, `memory_sync`, `memory_analytics`\n- **SQLite Backend**: Persistent `.swarm/memory.db` with 12 specialized tables\n\n#### **📊 Performance \u0026 Monitoring** (10 tools)\n- `performance_report`, `bottleneck_analyze`, `token_usage`\n- `benchmark_run`, `metrics_collect`, `trend_analysis`\n- `health_check`, `diagnostic_run`, `usage_stats`\n\n#### **🔄 Workflow Automation** (10 tools)\n- `workflow_create`, `workflow_execute`, `workflow_export`\n- `automation_setup`, `pipeline_create`, `scheduler_manage`\n- `trigger_setup`, `batch_process`, `parallel_execute`\n\n#### **📦 GitHub Integration** (6 tools)\n- `github_repo_analyze`, `github_pr_manage`, `github_issue_track`\n- `github_release_coord`, `github_workflow_auto`, `github_code_review`\n\n#### **🤖 Dynamic Agents** (6 tools)\n- `daa_agent_create`, `daa_capability_match`, `daa_resource_alloc`\n- `daa_lifecycle_manage`, `daa_communication`, `daa_consensus`\n\n#### **🛡️ System \u0026 Security** (8 tools)\n- `security_scan`, `backup_create`, `restore_system`\n- `config_manage`, `features_detect`, `log_analysis`\n\n### **📊 GitHub Integration**\n```bash\n# GitHub workflow orchestration and coordination\nnpx claude-flow@alpha github gh-coordinator analyze --analysis-type security\nnpx claude-flow@alpha github pr-manager review --multi-reviewer --ai-powered\nnpx claude-flow@alpha github release-manager coord --version 2.0.0 --auto-changelog\nnpx claude-flow@alpha github repo-architect optimize --structure-analysis\nnpx claude-flow@alpha github issue-tracker manage --project-coordination\nnpx claude-flow@alpha github sync-coordinator align --multi-package\n```\n\n---\n\n## 🛡️ **Seamless Claude Code Integration**\n\n### **Auto-MCP Server Setup**\nv2.0.0 Alpha automatically configures MCP servers for seamless Claude Code integration:\n\n```bash\n# Automatic MCP integration (happens during init)\n✅ claude-flow MCP server configured\n✅ ruv-swarm MCP server configured  \n✅ 87 tools available in Claude Code\n✅ --dangerously-skip-permissions set as default\n```\n\n### **Enhanced SPARC Workflows**\n```bash\n# Advanced SPARC development with neural enhancement\nnpx claude-flow@alpha sparc mode --type \"neural-tdd\" --auto-learn\nnpx claude-flow@alpha sparc workflow --phases \"all\" --ai-guided --memory-enhanced\n```\n\n---\n\n## 🧠 **Cognitive Computing Features**\n\n### **🎯 Neural Pattern Recognition**\n- **27+ Cognitive Models**: Adaptive learning from successful operations\n- **Pattern Analysis**: Real-time behavior analysis and optimization\n- **Decision Tracking**: Complete audit trail of AI decisions\n- **Performance Learning**: Continuous improvement from past executions\n\n### **🔄 Self-Healing Systems**\n```bash\n# Automatic error recovery and optimization\nnpx claude-flow@alpha health check --components all --auto-heal\nnpx claude-flow@alpha fault tolerance --strategy retry-with-learning\nnpx claude-flow@alpha bottleneck analyze --auto-optimize\n```\n\n### **💾 Advanced Memory Architecture**\n- **SQLite Persistence**: Robust `.swarm/memory.db` storage with 12 specialized tables\n- **Cross-Session Persistence**: Remember context across Claude Code sessions\n- **Namespace Management**: Organized memory with hierarchical access\n- **Enhanced Schema**: Agent interactions, training data, performance metrics, and more\n- **Memory Compression**: Efficient storage of large coordination contexts\n- **Distributed Sync**: Share memory across multiple AI instances\n\n---\n\n## 📊 **Performance Metrics**\n\n### **🏆 Industry-Leading Results**\n- **✅ 84.8% SWE-Bench Solve Rate**: Superior problem-solving through hive-mind coordination\n- **✅ 32.3% Token Reduction**: Efficient task breakdown reduces costs significantly\n- **✅ 2.8-4.4x Speed Improvement**: Parallel coordination maximizes throughput\n- **✅ 87 MCP Tools**: Most comprehensive AI tool suite available\n- **✅ Zero-Config Setup**: Automatic MCP integration with Claude Code\n\n### **🚀 Available Capabilities**\n```bash\n# Check memory system performance\nnpx claude-flow@alpha memory stats\nnpx claude-flow@alpha memory list\n\n# Test GitHub coordination modes\nnpx claude-flow@alpha github gh-coordinator --help\nnpx claude-flow@alpha github pr-manager --help\n\n# Workflow orchestration\nnpx claude-flow@alpha workflow create --name \"Development Pipeline\" --parallel\n```\n\n---\n\n## 🎮 **Advanced Usage Examples**\n\n### **🏗️ Full-Stack Development**\n```bash\n# Deploy complete development swarm\nnpx claude-flow@alpha hive-mind spawn \"Build e-commerce platform with React, Node.js, and PostgreSQL\" \\\n  --agents 10 \\\n  --strategy parallel \\\n  --memory-namespace ecommerce\n\n# Monitor progress in real-time\nnpx claude-flow@alpha swarm monitor --dashboard --real-time\n```\n\n### **🔬 Research \u0026 Analysis**\n```bash\n# Deploy research swarm with neural enhancement\nnpx claude-flow@alpha swarm \"Research AI safety in autonomous systems\" \\\n  --strategy research \\\n  --neural-patterns enabled \\\n  --memory-compression high\n\n# Analyze results with cognitive computing\nnpx claude-flow@alpha cognitive analyze --target research-results\n```\n\n### **🛡️ Security \u0026 Compliance**\n```bash\n# Automated security analysis with AI coordination\nnpx claude-flow@alpha github gh-coordinator analyze --analysis-type security --target ./src\nnpx claude-flow@alpha github repo-architect optimize --security-focused --compliance SOC2\nnpx claude-flow@alpha hive-mind spawn \"security audit and compliance review\" --claude\n```\n\n---\n\n## 🏗️ **Alpha Architecture Overview**\n\n### **🐝 Hive-Mind Coordination Layer**\n```\n┌─────────────────────────────────────────────────────────┐\n│                    👑 Queen Agent                       │\n│              (Master Coordinator)                      │\n├─────────────────────────────────────────────────────────┤\n│  🏗️ Architect │ 💻 Coder │ 🧪 Tester │ 🔍 Research │ 🛡️ Security │\n│      Agent    │   Agent  │   Agent   │    Agent    │    Agent    │\n├─────────────────────────────────────────────────────────┤\n│           🧠 Neural Pattern Recognition Layer           │\n├─────────────────────────────────────────────────────────┤\n│              💾 Distributed Memory System               │\n├─────────────────────────────────────────────────────────┤\n│            ⚡ 87 MCP Tools Integration Layer            │\n├─────────────────────────────────────────────────────────┤\n│              🛡️ Claude Code Integration                 │\n└─────────────────────────────────────────────────────────┘\n```\n\n### **🔄 Coordination Strategies**\n- **Hierarchical**: Queen-led with specialized worker agents\n- **Mesh**: Peer-to-peer coordination for complex tasks\n- **Hybrid**: Dynamic strategy selection based on task complexity\n- **Neural-Enhanced**: AI-optimized coordination patterns\n\n---\n\n## 🛠️ **Alpha Installation \u0026 Setup**\n\n### **🚀 Quick Alpha Installation**\n```bash\n# Global installation (recommended for testing)\nnpm install -g claude-flow@alpha\n\n# Or use NPX for instant testing\nnpx claude-flow@alpha init --force\n\n# Verify installation\nclaude-flow --version  # Should show 2.0.0-alpha.53\n```\n\n### **🔧 Enhanced Configuration**\n```bash\n# Initialize with full alpha features\nnpx claude-flow@alpha init --force --hive-mind --neural-enhanced\n\n# Configure Claude Code integration\nnpx claude-flow@alpha mcp setup --auto-permissions --87-tools\n\n# Test hive-mind coordination\nnpx claude-flow@alpha hive-mind test --agents 5 --coordination-test\n```\n\n---\n\n## 📋 **Alpha Command Reference**\n\nFor complete command documentation, run:\n```bash\nnpx claude-flow@alpha --help          # Main help\nnpx claude-flow@alpha help \u003ccommand\u003e  # Detailed command help\n```\n\n**Key Commands:**\n- **Hive-Mind**: `hive-mind wizard`, `hive-mind spawn`, `hive-mind status`\n- **Neural**: `neural train`, `neural predict`, `cognitive analyze`\n- **Memory**: `memory store`, `memory query`, `memory stats`, `memory export/import`\n- **GitHub**: `github \u003cmode\u003e` (6 specialized modes available)\n- **Workflows**: `workflow create`, `batch process`, `pipeline create`\n\n---\n\n## 🧪 **Alpha Testing \u0026 Development**\n\n### **🐛 Bug Reports \u0026 Feedback**\nFound issues with the alpha? We want to hear from you!\n\n- **🐛 Report Bugs**: [GitHub Issues](https://github.com/ruvnet/claude-flow/issues)\n- **💡 Feature Requests**: Use the \"Alpha Feedback\" label\n- **🛠️ Development**: Check the [`claude-flow-v2.0.0`](https://github.com/ruvnet/claude-flow/tree/claude-flow-v2.0.0) branch\n- **📋 Alpha Testing**: Join our alpha testing program\n\n### **🔬 Testing the Alpha**\n```bash\n# Test available GitHub modes\nnpx claude-flow@alpha github gh-coordinator --help\nnpx claude-flow@alpha github pr-manager --help  \nnpx claude-flow@alpha github issue-tracker --help\nnpx claude-flow@alpha github release-manager --help\nnpx claude-flow@alpha github repo-architect --help\nnpx claude-flow@alpha github sync-coordinator --help\n\n# Test memory functionality\nnpx claude-flow@alpha memory stats\nnpx claude-flow@alpha memory store \"test\" \"alpha testing data\"\nnpx claude-flow@alpha memory query \"test\"\n\n# Test workflow execution\nnpx claude-flow@alpha workflow create --name \"Test Pipeline\" --parallel\n```\n\n### **📊 Alpha Metrics Dashboard**\n```bash\n# Check memory usage and statistics\nnpx claude-flow@alpha memory stats\n\n# View available GitHub coordination modes\nnpx claude-flow@alpha github --help\n\n# Test workflow capabilities\nnpx claude-flow@alpha workflow --help\n```\n\n---\n\n## 🚀 **Roadmap to Stable v2.0.0**\n\n### **🎯 Alpha Phase (Current)**\n- ✅ Hive-mind coordination system\n- ✅ 87 MCP tools integration\n- ✅ Neural pattern recognition\n- ✅ Distributed memory architecture\n- ✅ Auto-MCP setup for Claude Code\n\n### **🔄 Beta Phase (Coming Soon)**\n- 🔜 Enhanced swarm intelligence algorithms\n- 🔜 Advanced cognitive computing features\n- 🔜 Enterprise security and compliance\n- 🔜 Multi-cloud deployment automation\n- 🔜 Real-time collaboration features\n\n### **🏆 Stable v2.0.0 (Q2 2025)**\n- 🎯 Production-ready hive-mind orchestration\n- 🎯 Complete neural computing suite\n- 🎯 Enterprise-grade security and monitoring\n- 🎯 Comprehensive documentation and tutorials\n- 🎯 Professional support and training\n\n---\n\n## 🤝 **Contributing to Alpha**\n\n### **🛠️ Alpha Development Setup**\n```bash\n# Clone the alpha development branch\ngit clone https://github.com/ruvnet/claude-flow.git\ncd claude-flow\ngit checkout claude-flow-v2.0.0\n\n# Install alpha dependencies\nnpm install\n\n# Build alpha version\nnpm run build:alpha\n\n# Test alpha features\nnpm run test:alpha\n```\n\n### **🔬 Alpha Testing Guidelines**\n- Focus on hive-mind coordination testing\n- Test neural pattern recognition accuracy\n- Validate memory system persistence\n- Verify Claude Code MCP integration\n- Report performance metrics and bottlenecks\n\n---\n\n## 🛡️ **Enhanced Safety \u0026 Security Features**\n\n### **Enterprise-Grade Security in v2.0.0 Alpha**\n\nClaude-Flow v2.0.0 introduces revolutionary safety features that ensure secure, reliable AI orchestration at scale:\n\n#### **🔐 Auto-Configured MCP Permissions**\n```bash\n# Automatic settings.local.json creation during init\n# Pre-approves trusted MCP tools - no more permission prompts!\n{\n  \"permissions\": {\n    \"allow\": [\n      \"mcp__ruv-swarm\",\n      \"mcp__claude-flow\"\n    ],\n    \"deny\": []\n  }\n}\n```\n\n#### **🌐 Quantum-Resistant Security Architecture**\n- **QuDag Networks**: Future-proof encryption for global communications\n- **Byzantine Fault Tolerance**: Consensus protocols prevent malicious agents\n- **Zero-Trust Agent Communication**: Every inter-agent message is validated\n- **Encrypted Memory Storage**: Cross-session persistence with AES-256 encryption\n\n#### **🛡️ Multi-Layer Safety Mechanisms**\n\n##### **1. Hook-Based Validation System**\n```bash\n# Pre-execution safety checks\nnpx claude-flow hooks pre-command --validate-security\nnpx claude-flow hooks pre-edit --check-permissions\n```\n\n##### **2. Agent Isolation \u0026 Sandboxing**\n- Each agent runs in isolated context\n- Resource limits prevent runaway processes\n- Automatic timeout on long-running operations\n- Memory usage caps per agent\n\n##### **3. Audit Trail \u0026 Compliance**\n```bash\n# Complete audit logging\nnpx claude-flow security audit --full-trace\nnpx claude-flow security compliance --standard SOC2\n```\n\n##### **4. Real-Time Threat Detection**\n- Pattern recognition for anomalous behavior\n- Automatic agent suspension on security violations\n- Neural network-based threat prediction\n- Self-healing security responses\n\n#### **🔒 Secure Communication Protocols**\n\n##### **Cross-Boundary Security**\n- End-to-end encryption for all agent communications\n- \u003c1ms latency with full encryption\n- Secure WebSocket connections with TLS 1.3\n- Certificate pinning for MCP servers\n\n##### **DAA Security Features**\n```bash\n# Secure agent creation with resource limits\nnpx claude-flow daa agent-create \\\n  --security-level high \\\n  --resource-limits \"cpu:50%,memory:2GB\" \\\n  --sandbox enabled\n```\n\n#### **🚨 Safety Guardrails**\n\n##### **Automatic Safety Checks**\n1. **Code Injection Prevention**: Sanitizes all inputs\n2. **Path Traversal Protection**: Validates file operations\n3. **Command Injection Blocking**: Secure command execution\n4. **Memory Overflow Protection**: Prevents buffer attacks\n\n##### **Rollback \u0026 Recovery**\n```bash\n# Instant rollback on security issues\nnpx claude-flow init --rollback --security-breach\nnpx claude-flow recovery --point last-safe-state\n```\n\n#### **📊 Security Monitoring Dashboard**\n```bash\n# Real-time security monitoring\nnpx claude-flow security monitor --dashboard\nnpx claude-flow security scan --deep --report\n\n# Security metrics and alerts\nnpx claude-flow security metrics --last-24h\nnpx claude-flow security alerts --configure\n```\n\n#### **🔧 Auto-Configured Security**\nClaude-Flow v2.0.0 Alpha automatically configures secure defaults:\n- Agent isolation and resource limits\n- Encrypted memory storage with AES-256\n- Complete audit logging for all operations\n- Neural threat detection and prevention\n- Auto-approved MCP permissions for trusted tools\n\n#### **🛡️ Defense-in-Depth Architecture**\n```\n┌─────────────────────────────────────────────────────────┐\n│                 🔐 Security Gateway                     │\n├─────────────────────────────────────────────────────────┤\n│     🛡️ Hook Validation │ 🔒 Permission Layer            │\n├─────────────────────────────────────────────────────────┤\n│          🚨 Threat Detection \u0026 Response                 │\n├─────────────────────────────────────────────────────────┤\n│     🔐 Encrypted Communication │ 📊 Audit Logging       │\n├─────────────────────────────────────────────────────────┤\n│            🐝 Isolated Agent Sandboxes                  │\n└─────────────────────────────────────────────────────────┘\n```\n\n### **✅ Security Best Practices**\n- Regular security scans with `npx claude-flow security scan`\n- Enable audit logging for production environments\n- Use high security level for sensitive operations\n- Configure resource limits for all agents\n- Regular backup and recovery testing\n\n---\n\n## 📚 **Additional Documentation**\n\n### Core Documentation\n- [Complete API Reference](docs/API.md) - Comprehensive API documentation\n- [CLI Commands Guide](docs/CLI.md) - All command-line options\n- [Architecture Overview](docs/ARCHITECTURE.md) - System design and internals\n- [Examples Directory](examples/) - Code examples and demos\n\n### New Features (v2.0.0)\n- [🔒 Git Checkpoint System](docs/GIT_CHECKPOINT_HOOKS.md) - Automatic Git checkpoints for Claude Code sessions\n- [📊 Real Performance Tracking](docs/REAL_PERFORMANCE_TRACKING.md) - Actual metrics collection and analysis\n- [🪟 Windows Installation](docs/windows-installation.md) - Special instructions for Windows users\n\n### Integration Guides\n- [MCP Server Setup](docs/mcp-setup.md) - Model Context Protocol configuration\n- [Claude Code Integration](docs/claude-code-integration.md) - Enhanced AI workflows\n- [GitHub Workflows](docs/github-workflows.md) - Repository automation\n\n---\n\n## 📄 **License**\n\nMIT License - see [LICENSE](./LICENSE) for details.\n\n**Alpha Disclaimer**: This is an alpha release intended for testing and feedback. Use in production environments is not recommended.\n\n---\n\n## 🎉 **Alpha Credits**\n\n- **🧠 Hive-Mind Architecture**: Inspired by natural swarm intelligence\n- **⚡ Neural Computing**: Advanced AI coordination patterns  \n- **🛡️ Claude Code Integration**: Seamless AI development workflow\n- **🚀 Performance Optimization**: 2.8-4.4x speed improvements through parallel coordination\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### **🚀 Ready to experience the future of AI development?**\n\n```bash\nnpx claude-flow@alpha init --force\n```\n\n**Join the alpha testing revolution!**\n\n[![GitHub](https://img.shields.io/badge/GitHub-Alpha%20Branch-blue?style=for-the-badge\u0026logo=github)](https://github.com/ruvnet/claude-flow/tree/claude-flow-v2.0.0)\n[![NPM Alpha](https://img.shields.io/badge/NPM-Alpha%20Release-orange?style=for-the-badge\u0026logo=npm)](https://www.npmjs.com/package/claude-flow/v/alpha)\n[![Discord](https://img.shields.io/badge/Discord-Agentics%20Community-purple?style=for-the-badge\u0026logo=discord)](https://discord.com/invite/dfxmpwkG2D)\n\n---\n\n## Star History\n\n\u003ca href=\"https://www.star-history.com/#ruvnet/claude-flow\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=ruvnet/claude-flow\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=ruvnet/claude-flow\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=ruvnet/claude-flow\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n---\n\n**Built with ❤️ by [rUv](https://github.com/ruvnet) | Powered by Revolutionary AI**\n\n*v2.0.0 Alpha - The Future of AI Orchestration*\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruvnet%2Fclaude-flow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fruvnet%2Fclaude-flow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruvnet%2Fclaude-flow/lists"}