Skip to content

🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, distributed swarm intelligence, RAG integration, and native Claude Code support via MCP protocol. Ranked #1 in agent-based frameworks.

License

Notifications You must be signed in to change notification settings

ruvnet/claude-flow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌊 Claude-Flow v2.7.0: Enterprise AI Orchestration Platform

🌟 Star on GitHub πŸ“ˆ Downloads πŸ“¦ Latest Release ⚑ Claude Code πŸ›οΈ Agentics Foundation πŸ›‘οΈ MIT License

🌟 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 for special instructions

⚠️ IMPORTANT: Claude Code must be installed first:

# 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

# 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:

# 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 - 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
# 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

🧠 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
# 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)

# 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:

# For better semantic accuracy with text-embedding-3-small (1536 dimensions) # Set OPENAI environment variable (see ReasoningBank documentation)

🐝 Swarm Orchestration

Quick Swarm Commands

# 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

# 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

# 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


πŸͺ Advanced Hooks System

Automated Workflow Enhancement

Claude-Flow automatically configures hooks for enhanced operations:

# 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

# 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

# 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

# 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

πŸš€ Release Notes & Changelogs

🧠 AgentDB Integration (96x-164x Performance Boost)

⚑ Performance & Quality

πŸ› οΈ Advanced Topics

βš™οΈ Configuration & Setup


🀝 Community & Support


πŸš€ 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

Star History Chart

πŸ“„ License

MIT License - see LICENSE for details


Built with ❀️ by rUv | Powered by Revolutionary AI

v2.7.0-alpha.10 - Semantic Search Fixed + ReasoningBank Node.js Backend