Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ruvnet/ruflo/llms.txt
Use this file to discover all available pages before exploring further.
The plugin system extends Ruflo’s capabilities through a curated marketplace of 35 official plugins. Plugins add MCP tools, lifecycle hooks, background workers, slash commands, and agent definitions to your Ruflo installation. They compose freely: install a memory plugin alongside a security plugin and both integrate into the same hooks system and MCP server automatically.
Managing Plugins
# Install a plugin
npx ruflo@latest plugins install -n ruflo-rag-memory
# List installed plugins
npx ruflo@latest plugins list
# Update a plugin to the latest version
npx ruflo@latest plugins update -n ruflo-rag-memory
# Remove a plugin
npx ruflo@latest plugins remove -n ruflo-rag-memory
Plugins installed via npx ruflo@latest plugins install register their MCP tools and hooks into the running Ruflo server automatically. No manual configuration is required. Use /plugin install inside Claude Code for the slash-command-only (lite) install path that does not register MCP tools.
Core & Orchestration
These six plugins form the foundation of any Ruflo installation. ruflo-core is a dependency of all other plugins.
| Plugin | What It Does | Install |
|---|
ruflo-core | Foundation: server, health checks, plugin discovery | npx ruflo@latest plugins install -n ruflo-core |
ruflo-swarm | Coordinate multiple agents as a team | npx ruflo@latest plugins install -n ruflo-swarm |
ruflo-autopilot | Let agents run autonomously in a loop | npx ruflo@latest plugins install -n ruflo-autopilot |
ruflo-loop-workers | Schedule background tasks on a timer | npx ruflo@latest plugins install -n ruflo-loop-workers |
ruflo-workflows | Reusable multi-step task templates | npx ruflo@latest plugins install -n ruflo-workflows |
ruflo-federation | Agents on different machines collaborate securely | npx ruflo@latest plugins install -n ruflo-federation |
ruflo-federation implements the zero-trust agent communication layer: identity via mTLS + ed25519 challenge-response, PII-gated data flow with 14-type detection, behavioral trust scoring, and HIPAA/SOC2/GDPR audit trails. Agents on different machines or orgs discover each other, prove identity, and exchange work — with secrets stripped before anything leaves your node.
Memory & Knowledge
| Plugin | What It Does | Install |
|---|
ruflo-agentdb | Fast vector database for agent memory | npx ruflo@latest plugins install -n ruflo-agentdb |
ruflo-rag-memory | Smart retrieval: hybrid search, graph hops, diversity ranking | npx ruflo@latest plugins install -n ruflo-rag-memory |
ruflo-rvf | Save and restore agent memory across sessions | npx ruflo@latest plugins install -n ruflo-rvf |
ruflo-ruvector | GPU-accelerated search, Graph RAG, 103 tools | npx ruflo@latest plugins install -n ruflo-ruvector |
ruflo-knowledge-graph | Build and traverse entity relationship maps | npx ruflo@latest plugins install -n ruflo-knowledge-graph |
ruflo-agentdb is the recommended default memory backend. It provides HNSW-indexed vector search that is measured ~1.9x faster than brute force at N=20k and ~3.2x–4.7x faster at N=5k, with recall@10 of approximately 0.99.
ruflo-ruvector exposes the full RuVector agentic database: GPU-accelerated HNSW, Graph RAG, Flash Attention (2.49–7.47x speedup), and 103 MCP tools. Use this when you need the full intelligence stack beyond what the built-in AgentDB provides.
Intelligence & Learning
| Plugin | What It Does | Install |
|---|
ruflo-intelligence | Agents learn from past successes | npx ruflo@latest plugins install -n ruflo-intelligence |
ruflo-graph-intelligence | Sublinear graph reasoning: PageRank, delta updates | npx ruflo@latest plugins install -n ruflo-graph-intelligence |
ruflo-daa | Dynamic agent behavior and cognitive patterns | npx ruflo@latest plugins install -n ruflo-daa |
ruflo-ruvllm | Run local LLMs (Ollama, etc.) with smart routing | npx ruflo@latest plugins install -n ruflo-ruvllm |
ruflo-goals | Break big goals into plans and track progress | npx ruflo@latest plugins install -n ruflo-goals |
ruflo-graph-intelligence implements the knowledge graph layer (ADR-123): PageRank-ranked insights, Jaccard-similarity community detection, and delta updates that avoid full re-indexing on every session. Pairs with ruflo-agentdb for the full intelligence loop.
ruflo-ruvllm integrates local LLM providers (Ollama, LM Studio, vLLM, Together, Groq) with the same smart routing as the cloud providers. Cost-based routing selects the cheapest model that meets the task’s quality requirements; automatic failover tries the next provider if one is unavailable.
Code Quality & Testing
| Plugin | What It Does | Install |
|---|
ruflo-testgen | Find missing tests and generate them automatically | npx ruflo@latest plugins install -n ruflo-testgen |
ruflo-browser | Automate browser testing with Playwright | npx ruflo@latest plugins install -n ruflo-browser |
ruflo-jujutsu | Analyze git diffs, score risk, suggest reviewers | npx ruflo@latest plugins install -n ruflo-jujutsu |
ruflo-docs | Generate and maintain documentation automatically | npx ruflo@latest plugins install -n ruflo-docs |
ruflo-testgen hooks into the testgaps background worker to detect code changes without corresponding test coverage and generates the missing tests automatically using the coder and tester agent types.
Security & Compliance
| Plugin | What It Does | Install |
|---|
ruflo-security-audit | Scan for vulnerabilities and CVEs | npx ruflo@latest plugins install -n ruflo-security-audit |
ruflo-aidefence | Block prompt injection, detect PII, safety scanning | npx ruflo@latest plugins install -n ruflo-aidefence |
ruflo-aidefence is the recommended first-line security layer for any production installation. It intercepts all inbound tool calls and message content, blocks prompt injection attempts, detects and redacts PII (14 entity types), and emits structured audit events for compliance reporting.
Architecture & Methodology
| Plugin | What It Does | Install |
|---|
ruflo-adr | Track architecture decisions with a living record | npx ruflo@latest plugins install -n ruflo-adr |
ruflo-ddd | Scaffold domain-driven design: contexts, aggregates, events | npx ruflo@latest plugins install -n ruflo-ddd |
ruflo-sparc | Guided 5-phase development methodology with quality gates | npx ruflo@latest plugins install -n ruflo-sparc |
ruflo-metaharness | Grade your agent setup, scan tool configs for security risks | npx ruflo@latest plugins install -n ruflo-metaharness |
ruflo-arena | Competitive ruliology: pit agent strategies in tournaments | npx ruflo@latest plugins install -n ruflo-arena |
ruflo-metaharness audits your Ruflo installation itself: grades agent readiness on a 1–100 scale, scans tool configurations for security issues, snapshots the project state to catch regressions over time, and matches your repo to known-good templates. ruflo eject converts a Ruflo project into a standalone agent toolkit with its own name and no Ruflo dependency.
ruflo-arena runs competitive hill-climbing tournaments between agent strategies (ADR-147/148). Strategies compete on benchmark tasks, winners are co-evolved, and the best-performing configurations propagate back into your routing table.
DevOps & Observability
| Plugin | What It Does | Install |
|---|
ruflo-migrations | Manage database schema changes safely | npx ruflo@latest plugins install -n ruflo-migrations |
ruflo-observability | Structured logs, traces, and metrics in one place | npx ruflo@latest plugins install -n ruflo-observability |
ruflo-cost-tracker | Track token usage, set budgets, get cost alerts | npx ruflo@latest plugins install -n ruflo-cost-tracker |
ruflo-cost-tracker integrates with the Thompson sampling model router to surface per-session and per-agent token costs, set hard budget limits that halt execution, and emit cost alerts when thresholds are crossed.
Extensibility
| Plugin | What It Does | Install |
|---|
ruflo-agent | Run agents: local WASM sandbox + Anthropic Cloud Managed Agents | npx ruflo@latest plugins install -n ruflo-agent |
ruflo-plugin-creator | Scaffold, validate, and publish your own plugins | npx ruflo@latest plugins install -n ruflo-plugin-creator |
ruflo-agent provides two agent execution environments: a local WASM sandbox (rvagent) for isolation without network access, and Anthropic Claude Managed Agents (cloud) for full capability with managed compute.
Domain-Specific
| Plugin | What It Does | Install |
|---|
ruflo-iot-cognitum | IoT device management, trust scoring, anomaly detection | npx ruflo@latest plugins install -n ruflo-iot-cognitum |
ruflo-neural-trader | AI trading with 4 agents, backtesting, 112+ tools | npx ruflo@latest plugins install -n ruflo-neural-trader |
ruflo-market-data | Ingest market data, vectorize OHLCV, detect patterns | npx ruflo@latest plugins install -n ruflo-market-data |
ruflo-neural-trader ships 4 specialized trading agents (signal generator, risk manager, execution engine, portfolio optimizer), 112+ MCP tools, and a full backtesting harness against historical OHLCV data. Pairs with ruflo-market-data for live data ingestion and ruflo-iot-cognitum for portfolio-adjacent device telemetry.
Ready to extend Ruflo with your own capabilities? The ruflo-plugin-creator plugin scaffolds a complete plugin project with typed MCP tools, hooks, workers, and a publish pipeline. See the Building Plugins guide for a step-by-step walkthrough. 