🌊 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 integra
  • JavaScript 57.4%
  • TypeScript 28.3%
  • Python 12.9%
  • Shell 1.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
rUv 25af48cd1c
Merge pull request #871 from ruvnet/claude/align-flow-with-mcp-011CV45c34eF2MawJHUpj9XD
🚀 Release v2.7.34: MCP 2025-11 Compliance & Progressive Disclosure (Alpha)
2025-11-13 11:32:02 -05:00
.claude fix: v2.7.15 - Update dependencies and fix memory command 2025-10-25 18:02:21 +00:00
.claude-flow feat: Implement Phase 1 & 2 - Progressive Disclosure (98.7% Token Reduction) 2025-11-12 14:00:23 +00:00
.claude-plugin [release] v2.5.0-alpha.141 - SDK integration and settings updates 2025-10-10 14:27:17 +00:00
.githooks [feat] Complete agentic-flow integration with execution layer fixes 2025-10-10 23:28:11 +00:00
.github [release] v2.7.1 - Critical MCP Pattern Persistence Fix 2025-10-22 19:39:32 +00:00
.hive-mind 🏁 Session end checkpoint: session-20250826-142549 2025-08-26 14:25:49 +00:00
.research 🚀 Release v2.5.0-alpha.130 - Phase 4 SDK Integration Complete 2025-09-30 15:31:16 +00:00
.ruv-swarm/benchmarks feat: implement critical hook safety system & resolve all init issues (#167) 2025-07-08 11:44:04 -04:00
analysis-reports 🚀 Release v2.5.0-alpha.130 - Phase 4 SDK Integration Complete 2025-09-30 15:31:16 +00:00
assets Add comprehensive test suite for Claude-Flow Console 2025-06-17 22:53:53 +00:00
benchmark 🏁 Session end checkpoint: session-20250807-170706 2025-08-07 17:07:07 +00:00
bin chore: Release v2.7.34 - MCP 2025-11 Compliance & Progressive Disclosure 2025-11-12 21:58:46 +00:00
claude-flow-wiki@01dc5415fe Clean up repository: remove unnecessary files, analysis reports, and test directories 2025-09-18 22:10:49 +00:00
dist-cjs/src chore: Release v2.7.33 - MCP 2025-11 Compliance & Progressive Disclosure 2025-11-12 21:51:47 +00:00
docker feat: Docker regression testing & publishing preparation 2025-10-23 13:29:44 +00:00
docker-test fix: v2.7.18 - Return false instead of throwing error to allow JSON fallback in npx 2025-10-25 20:29:23 +00:00
docs chore: Release v2.7.33 - MCP 2025-11 Compliance & Progressive Disclosure 2025-11-12 21:51:47 +00:00
examples [release] v2.5.0-alpha.141 - SDK integration and settings updates 2025-10-10 14:27:17 +00:00
hooks [release] v2.5.0-alpha.141 - SDK integration and settings updates 2025-10-10 14:27:17 +00:00
models/phi-4-mini/cpu_and_mobile/cpu-int4-rtn-block-32-acc-level-4 [feat] Agent Booster Integration - Ultra-Fast Code Editing (352x faster) 2025-10-12 05:09:54 +00:00
patches fix: Add automatic AgentDB import extension patch 2025-10-24 19:30:39 +00:00
scripts fix: v2.7.22 - Fix misleading 'Enabled: false' log message in ReasoningBank 2025-10-25 21:06:20 +00:00
src chore: Release v2.7.33 - MCP 2025-11 Compliance & Progressive Disclosure 2025-11-12 21:51:47 +00:00
tests feat: Implement MCP 2025-11 Specification Compliance (Phase A & B) 2025-11-12 14:57:02 +00:00
.audit-ci.json 🔖 Checkpoint: Edit /workspaces/claude-code-flow/.audit-ci.json 2025-08-12 02:44:15 +00:00
.eslintignore fix: resolve development environment issues after test cleanup 2025-07-15 04:20:33 +00:00
.eslintrc.json 🚀 Release: Claude Flow v2.0.0-alpha.62 2025-07-18 13:35:41 +00:00
.gitignore [release] v2.7.0-alpha.11 - Skills System Integration 2025-10-20 01:15:53 +00:00
.npmignore 🔖 Task checkpoint: {{user_prompt}} ... 2025-09-26 14:51:31 +00:00
.npmrc fix: v2.7.12 - Move agentdb to optionalDependencies to avoid better-sqlite3 build failures 2025-10-25 03:47:41 +00:00
.prettierignore 🚀 Release: Claude Flow v2.0.0-alpha.62 2025-07-18 13:35:41 +00:00
.prettierrc.json 🚀 Release: Claude Flow v2.0.0-alpha.62 2025-07-18 13:35:41 +00:00
.releaserc.json feat: Complete Claude-Flow Advanced AI Agent Orchestration System 2025-06-10 03:48:41 +00:00
.swcrc 🔖 Checkpoint: Edit /workspaces/claude-code-flow/.swcrc 2025-09-26 15:24:41 +00:00
babel.config.cjs 🚀 Release: Claude Flow v2.0.0-alpha.62 2025-07-18 13:35:41 +00:00
CHANGELOG.md chore: Release v2.7.33 - MCP 2025-11 Compliance & Progressive Disclosure 2025-11-12 21:51:47 +00:00
claude-flow 🔖 Task checkpoint: Initialize GitHub checkpoint system ... 2025-09-26 14:37:02 +00:00
CLAUDE.md 🔖 Task checkpoint: {{user_prompt}} ... 2025-09-26 18:02:18 +00:00
codecov.yml feat: Complete Claude-Flow Advanced AI Agent Orchestration System 2025-06-10 03:48:41 +00:00
jest.config.js 🔖 Checkpoint: Edit /workspaces/claude-code-flow/jest.config.js 2025-08-12 02:43:13 +00:00
jest.setup.js chore: test suite migration: deno → node.js/jest (#228) 2025-07-13 00:20:12 -04:00
LICENSE Initial commit 2025-06-02 17:24:20 -04:00
package-lock.json chore: Release v2.7.34 - MCP 2025-11 Compliance & Progressive Disclosure 2025-11-12 21:58:46 +00:00
package.json chore: Release v2.7.34 - MCP 2025-11 Compliance & Progressive Disclosure 2025-11-12 21:58:46 +00:00
pnpm-lock.yaml chore: Add pnpm-lock.yaml for reproducible dependency management 2025-07-28 00:10:08 +01:00
README.md docs: Reorganize documentation structure for better navigation 2025-10-23 14:40:43 +00:00
tsconfig.cjs.json feat: implement critical hook safety system & resolve all init issues (#167) 2025-07-08 11:44:04 -04:00
tsconfig.cli.json v1.0.71 2025-06-17 18:32:39 +00:00
tsconfig.json feat: implement critical hook safety system & resolve all init issues (#167) 2025-07-08 11:44:04 -04:00

🌊 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