Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

🌊 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

🌟 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

  • 🧠 ReasoningBank Memory: Persistent SQLite storage with semantic search (2-3ms latency)
  • πŸ” Semantic Search: Hash-based embeddings - works without API keys
  • 🐝 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: .swarm/memory.db with 30+ specialized patterns
  • πŸͺ 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


⚑ 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

πŸ†• 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

ReasoningBank (Persistent SQLite Memory)

# Store memories with semantic search
npx claude-flow@alpha memory store api_key "REST API configuration" \
 --namespace backend --reasoningbank
# Query with semantic search (2-3ms latency)
npx claude-flow@alpha memory query "API config" \
 --namespace backend --reasoningbank
# βœ… Found 3 results (semantic search)
# 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
  • βœ… Semantic Search: MMR ranking 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 (requires API key)
export OPENAI_API_KEY=$YOUR_API_KEY
# Uses text-embedding-3-small (1536 dimensions)

🐝 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
  • 2-3ms query latency - ReasoningBank semantic search
  • 64 specialized agents - Complete development ecosystem
  • 100 MCP tools - Comprehensive automation toolkit

πŸ“š Documentation

Core Documentation

Release Notes

Advanced Topics

Configuration


🀝 Community & Support


πŸš€ Roadmap & Targets

Immediate (Q4 2025)

  • βœ… Semantic search fix (v2.7.0-alpha.10)
  • βœ… ReasoningBank Node.js backend
  • πŸ”„ 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
  • 25ドルK 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

About

🌊 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.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /