ruflo-agentdb

Ruflo turns Claude Code into a self-optimizing multi-agent platform. Deploy specialized AI agents in coordinated swarms that learn from every task, build persistent vector memory, and automate workflows -- with fault-tolerant consensus and intelligent routing that gets smarter over time.

User --> Ruflo (CLI/MCP) --> Router --> Swarm --> Agents --> Memory --> LLM Providers
                          ^                           |
                          +---- Learning Loop <-------+

New to Ruflo? You don't need to learn 314 MCP tools or 26 CLI commands. After init, just use Claude Code normally -- the hooks system automatically routes tasks, learns from successful patterns, and coordinates agents in the background.

---

Quick Start

Claude Code Plugin (Recommended)

Install Ruflo as a native Claude Code plugin -- adds skills, commands, agents, and MCP tools directly:

# Add the marketplace
/plugin marketplace add ruvnet/ruflo

# Install core + any plugins you need
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-autopilot@ruflo

All 19 plugins

Plugin	What it adds
ruflo-core	MCP server, /status, /doctor, plugin discovery, base agents
ruflo-swarm	Swarm coordination, Monitor streams, worktree isolation
ruflo-autopilot	Autonomous /loop completion with learning and prediction
ruflo-intelligence	Self-learning SONA patterns, trajectory learning, model routing
ruflo-agentdb	AgentDB controllers, HNSW vector search, RuVector embeddings
ruflo-aidefence	AI safety scanning, PII detection, prompt injection defense
ruflo-browser	Playwright browser automation for testing and scraping
ruflo-jujutsu	Git diff analysis, risk scoring, reviewer recommendations
ruflo-wasm	Sandboxed WASM agent creation and gallery sharing
ruflo-workflows	Workflow templates, orchestration, lifecycle management
ruflo-daa	Dynamic Agentic Architecture, cognitive patterns
ruflo-ruvllm	Local LLM inference, MicroLoRA, multi-provider chat
ruflo-rvf	RVF portable memory, session persistence, transfer
ruflo-loop-workers	Background /loop workers, CronCreate scheduling
ruflo-security-audit	Security scanning, CVE checks, dependency audit
ruflo-rag-memory	Memory bridge, simple store/search/recall interface
ruflo-testgen	Test gap detection, TDD workflow, tester agent
ruflo-docs	Doc generation, drift detection, docs-writer agent
ruflo-plugin-creator	Scaffold, validate, and publish new plugins

CLI Install

# One-line install
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

# Or via npx
npx ruflo@latest init --wizard

# Or install globally
npm install -g ruflo@latest

MCP Server

# Add Ruflo as an MCP server in Claude Code
claude mcp add ruflo -- npx -y @claude-flow/cli@latest

---

What You Get

Capability	Description
🤖 100+ Agents	Specialized agents for coding, testing, security, docs, architecture
🐝 Swarm Coordination	Hierarchical, mesh, and adaptive topologies with consensus
🧠 Self-Learning	SONA neural patterns, ReasoningBank, trajectory learning
💾 Vector Memory	HNSW-indexed AgentDB with 150x-12,500x faster search
⚡ Background Workers	12 auto-triggered workers (audit, optimize, testgaps, etc.)
🧩 Plugin Marketplace	19 native Claude Code plugins + 20 npm plugins
🔌 Multi-Provider	Claude, GPT, Gemini, Cohere, Ollama with smart routing
🛡️ Security	AIDefence, input validation, CVE remediation, path traversal prevention

Claude Code: With vs Without Ruflo