Claude-Flow — Enterprise AI orchestration for Claude
Claude-Flow (ruvnet) is a production-focused agent orchestration framework that extends Claude Code into a multi-agent development and execution platform. It provides a full stack for deploying coordinated agent swarms, persistent vector memory, model/provider routing, and learning-backed hooks so teams can automate complex engineering workflows reliably in production.
Core capabilities
- 54+ specialized agents (coder, tester, reviewer, security architect, etc.) ready for common development tasks.
- Swarm coordination with multiple topologies (hierarchical, mesh, ring, star, hybrid) and consensus support for fault tolerance.
- Persistent memory and retrieval using HNSW/AgentDB for fast semantic lookups and pattern storage.
- Self-learning intelligence: SONA + EWC++ pipeline for pattern distillation, preventing catastrophic forgetting and improving routing over time.
- Multi-provider LLM support with intelligent routing and automatic failover (Claude, OpenAI, Google, local models).
- Native MCP server integration for Claude Code (MCP tools, CLI and SDK) so the platform can be used from Claude, IDEs and other MCP clients.
- Security features including AIDefence-style prompt/jailbreak detection, input validation, sandboxing and CVE-aware practices.
- Plugin system and WASM extensions (RuVector / Agent Booster) for high-performance transforms and custom integrations.
Typical usage & integration
- Run interactive tooling via CLI and MCP (e.g. bootstrap with
npx claude-flow@v3alpha init, start MCP server withnpx claude-flow@v3alpha mcp start). - Use prebuilt skills for code review, test generation, refactors, CI/CD automation and security audits.
- Persist learned patterns and share/import pattern packs via a decentralized pattern marketplace (IPFS-enabled).
Technical highlights
- Architecture: User → Claude-Flow (CLI / MCP) → Router → Swarm → Agents → Memory → LLM Providers, with a learning loop (RETRIEVE → JUDGE → DISTILL → CONSOLIDATE).
- Embeddings & memory: ONNX/local embedding options and HNSW indices for sub-ms retrieval; optional centralized RuVector Postgres for large swarms.
- Optimization: Agent Booster (WASM) for mechanical edits (avoid LLM costs), model tiering (haiku/sonnet/opus) to reduce API spend.
Quick install (example)
# Install or run via npx
npx claude-flow@v3alpha init
npx claude-flow@v3alpha mcp start
# Spawn an agent to implement a task
npx claude-flow@v3alpha --agent coder --task "Implement user authentication"Who maintains it
The project is published under the GitHub organization/user ruvnet (homepage/reference: ruv.io). The repository includes detailed docs, MCP tools, CLI commands and an extensive README describing architecture, hooks, skills and deployment patterns.
Note: this summary is based on the project's README and repository metadata (created at 2025-06-02). For the latest releases, compatibility notes or governance details consult the repository and the project website.
