claude-flow

# 🌊 Claude-Flow v2.7.0: Enterprise AI Orchestration Platform <div align="center"> [](https://github.com/ruvnet/claude-flow) [](https://www.npmjs.com/package/claude-flow) [](https://www.npmjs.com/package/claude-flow) [](https://github.com/ruvnet/claude-flow) [](https://discord.com/invite/dfxmpwkG2D) [](https://opensource.org/licenses/MIT) </div> ## 🌟 **Overview** **Claude-Flow v2.7** is an enterprise-grade AI orchestration platform that combines **hive-mind swarm intelligence**, **persistent memory**, and **100+ advanced MCP tools** to revolutionize AI-powered development workflows. ### 🎯 **Key Features** - **🎨 25 Claude Skills**: Natural language-activated skills for development, GitHub, memory, and automation - **🚀 AgentDB v1.3.9 Integration**: 96x-164x faster vector search with semantic understanding (PR #830) - **🧠 Hybrid Memory System**: AgentDB + ReasoningBank with automatic fallback - **🔍 Semantic Vector Search**: HNSW indexing (O(log n)) + 9 RL algorithms - **🐝 Hive-Mind Intelligence**: Queen-led AI coordination with specialized worker agents - **🔧 100 MCP Tools**: Comprehensive toolkit for swarm orchestration and automation - **🔄 Dynamic Agent Architecture (DAA)**: Self-organizing agents with fault tolerance - **💾 Persistent Memory**: 150x faster search, 4-32x memory reduction (quantization) - **🪝 Advanced Hooks System**: Automated workflows with pre/post operation hooks - **📊 GitHub Integration**: 6 specialized modes for repository management - **🌐 Flow Nexus Cloud**: E2B sandboxes, AI swarms, challenges, and marketplace > 🔥 **Revolutionary AI Coordination**: Build faster, smarter, and more efficiently with AI-powered development orchestration > > 🆕 **NEW: AgentDB Integration**: 96x-164x performance boost with semantic vector search, reflexion memory, and skill library auto-consolidation --- ## ⚡ **Quick Start** ### 📋 **Prerequisites** - **Node.js 18+** (LTS recommended) - **npm 9+** or equivalent package manager - **Windows users**: See [Windows Installation Guide](./docs/windows-installation.md) for special instructions ⚠️ **IMPORTANT**: Claude Code must be installed first: ```bash # 1. Install Claude Code globally npm install -g @anthropic-ai/claude-code # 2. (Optional) Skip permissions check for faster setup claude --dangerously-skip-permissions ``` ### 🚀 **Install Latest Alpha** ```bash # NPX (recommended - always latest) npx claude-flow@alpha init --force npx claude-flow@alpha --help # Or install globally npm install -g claude-flow@alpha claude-flow --version # v2.7.0-alpha.10 ``` --- ## 🎨 **Skills System** Claude-Flow includes **25 specialized skills** that activate automatically via natural language - no commands to memorize: ```bash # Just describe what you want - skills activate automatically "Let's pair program on this feature" → pair-programming skill "Review this PR for security issues" → github-code-review skill "Use vector search to find similar code" → agentdb-vector-search skill "Create a swarm to build this API" → swarm-orchestration skill ``` **Skill Categories:** - **Development & Methodology** (3) - SPARC, pair programming, skill builder - **Intelligence & Memory** (6) - AgentDB integration with 150x-12,500x performance - **Swarm Coordination** (3) - Multi-agent orchestration and hive-mind - **GitHub Integration** (5) - PR review, workflows, releases, multi-repo - **Automation & Quality** (4) - Hooks, verification, performance analysis - **Flow Nexus Platform** (3) - Cloud sandboxes and neural training 📚 **[Complete Skills Tutorial](./docs/skills-tutorial.md)** - Full guide with usage examples --- ## 🆕 **What's New in v2.7.0-alpha.10** ### ✅ **Semantic Search Fixed** Critical bug fix for semantic search returning 0 results: - ✅ Fixed stale compiled code (dist-cjs/ now uses Node.js backend) - ✅ Fixed result mapping for `retrieveMemories()` flat structure - ✅ Fixed parameter mismatch (namespace vs domain) - ✅ 2-3ms query latency with hash embeddings - ✅ Works without API keys (deterministic 1024-dim embeddings) ### 🧠 **ReasoningBank Integration (agentic-flow@1.5.13)** - **Node.js Backend**: Replaced WASM with SQLite + better-sqlite3 - **Persistent Storage**: All memories saved to `.swarm/memory.db` - **Semantic Search**: MMR ranking with 4-factor scoring - **Database Tables**: patterns, embeddings, trajectories, links - **Performance**: 2ms queries, 400KB per pattern with embeddings ```bash # Semantic search now fully functional npx claude-flow@alpha memory store test "API configuration" --namespace semantic --reasoningbank npx claude-flow@alpha memory query "configuration" --namespace semantic --reasoningbank # ✅ Found 3 results (semantic search) in 2ms ``` 📚 **Release Notes**: [v2.7.0-alpha.10](./docs/RELEASE-NOTES-v2.7.0-alpha.10.md) ## 🧠 **Memory System Commands** ### **🚀 NEW: AgentDB v1.3.9 Integration (96x-164x Performance Boost)** **Revolutionary Performance Improvements:** - **Vector Search**: 96x faster (9.6ms → <0.1ms) - **Batch Operations**: 125x faster - **Large Queries**: 164x faster - **Memory Usage**: 4-32x reduction via quantization ```bash # Semantic vector search (understands meaning, not just keywords) npx claude-flow@alpha memory vector-search "user authentication flow" \ --k 10 --threshold 0.7 --namespace backend # Store with vector embedding for semantic search npx claude-flow@alpha memory store-vector api_design "REST endpoints" \ --namespace backend --metadata '{"version":"v2"}' # Get AgentDB integration status and capabilities npx claude-flow@alpha memory agentdb-info # Installation (hybrid mode - 100% backward compatible) npm install agentdb@1.3.9 ``` **New Features:** - ✅ **Semantic vector search** (HNSW indexing, O(log n)) - ✅ **9 RL algorithms** (Q-Learning, PPO, MCTS, Decision Transformer) - ✅ **Reflexion memory** (learn from past experiences) - ✅ **Skill library** (auto-consolidate successful patterns) - ✅ **Causal reasoning** (understand cause-effect relationships) - ✅ **Quantization** (binary 32x, scalar 4x, product 8-16x reduction) - ✅ **100% backward compatible** (hybrid mode with graceful fallback) **Documentation**: `docs/agentdb/PRODUCTION_READINESS.md` | **PR**: #830 --- ### **ReasoningBank (Legacy SQLite Memory - Still Supported)** ```bash # Store memories with pattern matching npx claude-flow@alpha memory store api_key "REST API configuration" \ --namespace backend --reasoningbank # Query with pattern search (2-3ms latency) npx claude-flow@alpha memory query "API config" \ --namespace backend --reasoningbank # ✅ Found 3 results (pattern matching) # List all memories npx claude-flow@alpha memory list --namespace backend --reasoningbank # Check status and statistics npx claude-flow@alpha memory status --reasoningbank # ✅ Total memories: 30 # Embeddings: 30 # Storage: .swarm/memory.db ``` **Features:** - ✅ **No API Keys Required**: Hash-based embeddings (1024 dimensions) - ✅ **Persistent Storage**: SQLite database survives restarts - ✅ **Pattern Matching**: LIKE-based search with similarity scoring - ✅ **Namespace Isolation**: Organize memories by domain - ✅ **Fast Queries**: 2-3ms average latency - ✅ **Process Cleanup**: Automatic database closing **Optional Enhanced Embeddings:** ```bash # For better semantic accuracy with text-embedding-3-small (1536 dimensions) # Set OPENAI environment variable (see ReasoningBank documentation) ``` --- ## 🐝 **Swarm Orchestration** ### **Quick Swarm Commands** ```bash # Quick task execution (recommended) npx claude-flow@alpha swarm "build REST API with authentication" --claude # Multi-agent coordination npx claude-flow@alpha swarm init --topology mesh --max-agents 5 npx claude-flow@alpha swarm spawn researcher "analyze API patterns" npx claude-flow@alpha swarm spawn coder "implement endpoints" npx claude-flow@alpha swarm status ``` ### **Hive-Mind for Complex Projects** ```bash # Initialize hive-mind system npx claude-flow@alpha hive-mind wizard npx claude-flow@alpha hive-mind spawn "build enterprise system" --claude # Session management npx claude-flow@alpha hive-mind status npx claude-flow@alpha hive-mind resume session-xxxxx ``` **When to Use:** | Feature | `swarm` | `hive-mind` | |---------|---------|-------------| | **Best For** | Quick tasks | Complex projects | | **Setup** | Instant | Interactive wizard | | **Memory** | Task-scoped | Project-wide SQLite | | **Sessions** | Temporary | Persistent + resume | --- ## 🔧 **MCP Tools Integration** ### **Setup MCP Servers** ```bash # Add Claude Flow MCP server (required) claude mcp add claude-flow npx claude-flow@alpha mcp start # Optional: Enhanced coordination claude mcp add ruv-swarm npx ruv-swarm mcp start # Optional: Cloud features (requires registration) claude mcp add flow-nexus npx flow-nexus@latest mcp start ``` ### **Available MCP Tools (100 Total)** **Core Tools:** - `swarm_init`, `agent_spawn`, `task_orchestrate` - `memory_usage`, `memory_search` - `neural_status`, `neural_train`, `neural_patterns` **Memory Tools:** - `mcp__claude-flow__memory_usage` - Store/retrieve persistent memory - `mcp__claude-flow__memory_search` - Pattern-based search **GitHub Tools:** - `github_repo_analyze`, `github_pr_manage`, `github_issue_track` **Performance Tools:** - `benchmark_run`, `performance_report`, `bottleneck_analyze` 📚 **Full Reference**: [MCP Tools Documentation](./docs/MCP-TOOLS.md) --- ## 🪝 **Advanced Hooks System** ### **Automated Workflow Enhancement** Claude-Flow automatically configures hooks for enhanced operations: ```bash # Auto-configures hooks during init npx claude-flow@alpha init --force ``` ### **Available Hooks** **Pre-Operation:** - `pre-task`: Auto-assigns agents by complexity - `pre-edit`: Validates files and prepares resources - `pre-command`: Security validation **Post-Operation:** - `post-edit`: Auto-formats code - `post-task`: Trains neural patterns - `post-command`: Updates memory **Session Management:** - `session-start`: Restores previous context - `session-end`: Generates summaries - `session-restore`: Loads memory --- ## 🎯 **Common Workflows** ### **Pattern 1: Single Feature Development** ```bash # Initialize once per feature npx claude-flow@alpha init --force npx claude-flow@alpha hive-mind spawn "Implement authentication" --claude # Continue same feature (reuse hive) npx claude-flow@alpha memory query "auth" --recent npx claude-flow@alpha swarm "Add password reset" --continue-session ``` ### **Pattern 2: Multi-Feature Project** ```bash # Project initialization npx claude-flow@alpha init --force --project-name "my-app" # Feature 1: Authentication npx claude-flow@alpha hive-mind spawn "auth-system" --namespace auth --claude # Feature 2: User management npx claude-flow@alpha hive-mind spawn "user-mgmt" --namespace users --claude ``` ### **Pattern 3: Research & Analysis** ```bash # Start research session npx claude-flow@alpha hive-mind spawn "Research microservices" \ --agents researcher,analyst --claude # Check learned knowledge npx claude-flow@alpha memory stats npx claude-flow@alpha memory query "microservices patterns" --reasoningbank ``` --- ## 📊 **Performance & Stats** - **84.8% SWE-Bench solve rate** - Industry-leading problem-solving - **32.3% token reduction** - Efficient context management - **2.8-4.4x speed improvement** - Parallel coordination - **96x-164x faster search** - 🆕 AgentDB vector search (9.6ms → <0.1ms) - **4-32x memory reduction** - 🆕 AgentDB quantization - **2-3ms query latency** - ReasoningBank pattern search (legacy) - **64 specialized agents** - Complete development ecosystem - **100 MCP tools** - Comprehensive automation toolkit - **180 AgentDB tests** - >90% coverage, production-ready --- ## 📚 **Documentation** ### **📖 Core Documentation** - **[Documentation Hub](./docs/)** - Complete documentation index with organized structure - **[Skills Tutorial](./docs/guides/skills-tutorial.md)** - Complete guide to 25 Claude Flow skills with natural language invocation - **[Installation Guide](./docs/INSTALLATION.md)** - Setup instructions - **[Memory System Guide](./docs/MEMORY-SYSTEM.md)** - ReasoningBank + AgentDB hybrid - **[MCP Tools Reference](./docs/MCP-TOOLS.md)** - Complete tool catalog - **[Agent System](./docs/AGENT-SYSTEM.md)** - All 64 agents ### **🚀 Release Notes & Changelogs** - **[v2.7.1](./docs/releases/v2.7.1/)** - Current stable release with critical fixes - **[v2.7.0-alpha.10](./docs/releases/v2.7.0-alpha.10/)** - Semantic search fix - **[v2.7.0-alpha.9](./docs/releases/v2.7.0-alpha.9/)** - Process cleanup - **[Changelog](./CHANGELOG.md)** - Full version history ### **🧠 AgentDB Integration (96x-164x Performance Boost)** - **[AgentDB Documentation](./docs/agentdb/)** - 🆕 Complete AgentDB v1.3.9 integration docs - [Production Readiness Guide](./docs/agentdb/PRODUCTION_READINESS.md) - Deployment guide - [Implementation Complete](./docs/agentdb/SWARM_IMPLEMENTATION_COMPLETE.md) - 3-agent swarm details (180 tests) - [Backward Compatibility](./docs/agentdb/BACKWARD_COMPATIBILITY_GUARANTEE.md) - 100% compatibility guarantee - [Integration Plan](./docs/agentdb/AGENTDB_INTEGRATION_PLAN.md) - Planning and design - [Optimization Report](./docs/agentdb/OPTIMIZATION_REPORT.md) - Performance analysis ### **⚡ Performance & Quality** - **[Performance Documentation](./docs/performance/)** - Optimization guides and benchmarks - [JSON Improvements](./docs/performance/PERFORMANCE-JSON-IMPROVEMENTS.md) - JSON optimization results - [Metrics Guide](./docs/performance/PERFORMANCE-METRICS-GUIDE.md) - Performance tracking - **[Bug Fixes](./docs/fixes/)** - Bug fix documentation and patches - **[Validation Reports](./docs/validation/)** - Test reports and verification results ### **🛠️ Advanced Topics** - **[Neural Module](./docs/NEURAL-MODULE.md)** - SAFLA self-learning - **[Goal Module](./docs/GOAL-MODULE.md)** - GOAP intelligent planning - **[Hive-Mind Intelligence](./docs/HIVE-MIND.md)** - Queen-led coordination - **[GitHub Integration](./docs/GITHUB-INTEGRATION.md)** - Repository automation ### **⚙️ Configuration & Setup** - **[CLAUDE.md Templates](./docs/CLAUDE-MD-TEMPLATES.md)** - Project configs - **[SPARC Methodology](./docs/SPARC.md)** - TDD patterns - **[Windows Installation](./docs/windows-installation.md)** - Windows setup --- ## 🤝 **Community & Support** - **GitHub Issues**: [Report bugs or request features](https://github.com/ruvnet/claude-flow/issues) - **Discord**: [Join the Agentics Foundation community](https://discord.com/invite/dfxmpwkG2D) - **Documentation**: [Complete guides and tutorials](https://github.com/ruvnet/claude-flow/wiki) - **Examples**: [Real-world usage patterns](https://github.com/ruvnet/claude-flow/tree/main/examples) --- ## 🚀 **Roadmap & Targets** ### **Immediate (Q4 2025)** - ✅ Semantic search fix (v2.7.0-alpha.10) - ✅ ReasoningBank Node.js backend - ✅ AgentDB v1.3.9 integration (PR #830) - 96x-164x performance boost - 🔄 AgentDB production deployment (Q4 2025) - 🔄 Enhanced embedding models - 🔄 Multi-user collaboration features ### **Q1 2026** - Advanced neural pattern recognition - Cloud swarm coordination - Real-time agent communication - Enterprise SSO integration ### **Growth Targets** - 5K+ GitHub stars, 50K npm downloads/month - $25K MRR, 15 enterprise customers - 90%+ error prevention - 30+ minutes saved per developer per week --- ## Star History <a href="https://www.star-history.com/#ruvnet/claude-flow&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ruvnet/claude-flow&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ruvnet/claude-flow&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=ruvnet/claude-flow&type=Date" /> </picture> </a> --- ## 📄 **License** MIT License - see [LICENSE](./LICENSE) for details --- **Built with ❤️ by [rUv](https://github.com/ruvnet) | Powered by Revolutionary AI** *v2.7.0-alpha.10 - Semantic Search Fixed + ReasoningBank Node.js Backend* </div>