Ruflo Plugin Marketplace and Custom Plugin Development

Ruflo’s plugin system serves two audiences. For practitioners, it provides a 35-plugin marketplace covering everything from vector memory and swarm coordination to IoT device management and AI trading. For builders, it exposes a fluent TypeScript SDK — PluginBuilder, MCPToolBuilder, HookBuilder — so you can add custom MCP tools, hooks, and background workers without touching Ruflo’s internals.

Install from the Marketplace

# Install a plugin by name
npx ruflo@latest plugins install -n ruflo-rag-memory

# List all installed plugins
npx ruflo@latest plugins list

# Update a plugin to the latest version
npx ruflo@latest plugins update -n ruflo-rag-memory

For Claude Code plugin installs (adds slash commands only, no MCP registration):

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-rag-memory@ruflo

Full Plugin Catalog

Core & Orchestration

Plugin	What it does
ruflo-core	Foundation — MCP server, health checks, plugin discovery, coder/researcher/reviewer agents
ruflo-swarm	Coordinate multiple agents as a team with hierarchical and mesh topologies
ruflo-autopilot	Let agents run autonomously in a loop with task prediction
ruflo-loop-workers	Schedule 12 background tasks on a timer via `/loop` or CronCreate
ruflo-workflows	Reusable multi-step task templates with parallel execution and branching
ruflo-federation	Agents on different machines collaborate securely with zero-trust identity

Memory & Knowledge

Plugin	What it does
ruflo-agentdb	Fast vector database for agent memory with HNSW search (150×–12,500× faster than brute force)
ruflo-rag-memory	SOTA RAG — hybrid search, Graph RAG, MMR diversity ranking, memory bridge
ruflo-rvf	Save and restore agent memory across sessions in portable RVF format
ruflo-ruvector	`ruvector` — GPU-accelerated FlashAttention-3, Graph RAG, 103 MCP tools, Brain AGI
ruflo-knowledge-graph	Build and traverse entity relationship maps with pathfinder traversal

Intelligence & Learning

Plugin	What it does
ruflo-intelligence	Agents learn from past successes via SONA neural patterns and trajectory learning
ruflo-graph-intelligence	Sublinear graph reasoning — PageRank, delta updates, complexity-aware execution (ADR-123)
ruflo-daa	Dynamic Agentic Architecture — dynamic agent behavior and cognitive patterns
ruflo-ruvllm	Run local LLMs (Ollama, MicroLoRA) with smart routing and chat formatting
ruflo-goals	Break big goals into GOAP plans and track progress with horizon management

Code Quality & Testing

Plugin	What it does
ruflo-testgen	Find missing tests and generate them with London School TDD workflow
ruflo-browser	Automate browser testing with Playwright
ruflo-jujutsu	Analyze git diffs, score commit risk, suggest reviewers
ruflo-docs	Generate and maintain documentation automatically with drift detection

Security & Compliance

Plugin	What it does
ruflo-security-audit	Scan for vulnerabilities and CVEs in dependencies and code
ruflo-aidefence	Block prompt injection, detect PII across 14 types, safety scanning

Architecture & Methodology

Plugin	What it does
ruflo-adr	Track architecture decisions with a living record — create, index, supersede, compliance-check
ruflo-ddd	Scaffold domain-driven design — bounded contexts, aggregates, domain events
ruflo-sparc	Guided 5-phase development methodology with quality gates
ruflo-metaharness	Grade your agent setup (1–100), scan tool configs for security issues, snapshot the project to catch regressions
ruflo-arena	Competitive ruliology — pit agent strategies against each other in tournaments, hill-climb and co-evolve the winners (ADR-147/148)

DevOps & Observability

Plugin	What it does
ruflo-migrations	Manage database schema changes safely
ruflo-observability	Structured logs, distributed traces, and metrics in one place
ruflo-cost-tracker	Track token usage, set budgets, get cost alerts

Extensibility

Plugin	What it does
ruflo-agent	Run agents — local WASM sandbox (rvagent) + Anthropic Claude Managed Agents (cloud)
ruflo-plugin-creator	Scaffold, validate, and publish your own plugins

Domain-Specific

Plugin	What it does
ruflo-iot-cognitum	IoT device management — trust scoring, anomaly detection, fleet management
ruflo-neural-trader	`neural-trader` — AI trading with 4 agents, LSTM/Transformer, Rust/NAPI backtesting, 112+ MCP tools
ruflo-market-data	Ingest market data, vectorize OHLCV, detect patterns

Recommended Stacks

Use Case	Plugins
Feature development	`ruflo-core` + `ruflo-swarm` + `ruflo-testgen` + `ruflo-ddd`
Security audit	`ruflo-core` + `ruflo-security-audit` + `ruflo-aidefence`
Architecture work	`ruflo-core` + `ruflo-adr` + `ruflo-ddd` + `ruflo-sparc`
Deep research	`ruflo-core` + `ruflo-goals` + `ruflo-rag-memory` + `ruflo-intelligence`
Vector search	`ruflo-core` + `ruflo-ruvector` + `ruflo-rag-memory` + `ruflo-knowledge-graph`
IoT development	`ruflo-core` + `ruflo-iot-cognitum` + `ruflo-agentdb`
Trading systems	`ruflo-core` + `ruflo-neural-trader` + `ruflo-market-data` + `ruflo-ruvector`

Build Your Own Plugin

Scaffold the plugin

The ruflo-plugin-creator plugin scaffolds a new plugin with the correct directory structure, a plugin.json manifest, and example tool/hook stubs:

npx ruflo@latest plugins create --name my-plugin

Or install the creator plugin first:

/plugin install ruflo-plugin-creator@ruflo

Implement with the PluginBuilder API

Use the fluent builder API from @claude-flow/plugins to define your plugin’s tools and hooks:

import {
  PluginBuilder,
  MCPToolBuilder,
  HookBuilder,
  HookEvent,
  HookPriority,
} from '@claude-flow/plugins';

const plugin = new PluginBuilder('my-plugin', '1.0.0')
  .withDescription('Code quality analysis plugin')
  .withAuthor('your-name')
  .withMCPTools([
    new MCPToolBuilder('analyze-code')
      .withDescription('Analyze code quality')
      .addStringParam('code', 'The code to analyze', { required: true })
      .addStringParam('language', 'Programming language')
      .withHandler(async (input) => ({
        content: [{ type: 'text', text: JSON.stringify({ issues: [], score: 0.95 }) }],
      }))
      .build(),
  ])
  .withHooks([
    new HookBuilder(HookEvent.PostTaskComplete)
      .withPriority(HookPriority.Normal)
      .when(ctx => ctx.data?.taskType === 'code-analysis')
      .withHandler(async (ctx) => {
        // ctx.data contains task result; persist via your memory backend
        return { success: true };
      })
      .build(),
  ])
  .build();

Validate the plugin

Check the plugin manifest, tool schemas, and hook definitions for correctness:

npx ruflo@latest plugins validate --name my-plugin

Test the plugin

Run the plugin’s test suite:

npx ruflo@latest plugins test --name my-plugin

Publish to the marketplace

Publish to the Ruflo plugin registry so others can install it with /plugin install:

npx ruflo@latest plugins publish --name my-plugin

Plugin SDK Components

Component	Description	Key Features
PluginBuilder	Fluent builder for assembling a plugin from parts	`.addTool()`, `.addHook()`, `.addWorker()`, lifecycle callbacks
MCPToolBuilder	Build typed MCP tools with parameter schemas	String, number, boolean, enum params; async handler
HookBuilder	Build lifecycle hooks with conditional execution	Priority levels, condition predicates, context transformers
WorkerPool	Managed worker pool with auto-scaling	Min/max workers, task queuing, graceful shutdown
ProviderRegistry	LLM provider management with fallback	Cost optimization, automatic failover across 5 providers

Performance targets: Plugin load <20ms · Hook execution <0.5ms · Worker spawn <50ms

Plugin Hook Events

Plugins can subscribe to these lifecycle events via HookBuilder. Use the HookEvent enum constants from @claude-flow/plugins — not raw strings:

Category	`HookEvent` Constant	Wire Value
Tool	`HookEvent.PreToolUse`	`hook:pre-tool-use`
Tool	`HookEvent.PostToolUse`	`hook:post-tool-use`
Session	`HookEvent.SessionStart`	`hook:session-start`
Session	`HookEvent.SessionEnd`	`hook:session-end`
Session	`HookEvent.SessionRestore`	`hook:session-restore`
Task	`HookEvent.PreTaskExecute`	`hook:pre-task-execute`
Task	`HookEvent.PostTaskComplete`	`hook:post-task-complete`
Task	`HookEvent.TaskFailed`	`hook:task-failed`
File	`HookEvent.PreFileWrite`	`hook:pre-file-write`
File	`HookEvent.PostFileWrite`	`hook:post-file-write`
File	`HookEvent.PreFileDelete`	`hook:pre-file-delete`
Command	`HookEvent.PreCommand`	`hook:pre-command`
Command	`HookEvent.PostCommand`	`hook:post-command`
Agent	`HookEvent.AgentSpawned`	`hook:agent-spawned`
Agent	`HookEvent.AgentTerminated`	`hook:agent-terminated`
Memory	`HookEvent.PreMemoryStore`	`hook:pre-memory-store`
Memory	`HookEvent.PostMemoryStore`	`hook:post-memory-store`
Learning	`HookEvent.PatternDetected`	`hook:pattern-detected`
Learning	`HookEvent.StrategyUpdated`	`hook:strategy-updated`
Plugin	`HookEvent.PluginLoaded`	`hook:plugin-loaded`
Plugin	`HookEvent.PluginUnloaded`	`hook:plugin-unloaded`

For the complete plugin SDK reference, see Building Plugins.

Get Started

Core Concepts

Guides

Configuration

Ruflo Plugin Marketplace and Custom Plugin Development

Install from the Marketplace

Full Plugin Catalog

Core & Orchestration

Memory & Knowledge

Intelligence & Learning

Code Quality & Testing

Security & Compliance

Architecture & Methodology

DevOps & Observability

Extensibility

Domain-Specific

Recommended Stacks

Build Your Own Plugin

Plugin SDK Components

Plugin Hook Events

Build docs developers (and LLMs) love

Get Started

Core Concepts

Guides

Configuration

Documentation Index

​Install from the Marketplace

​Full Plugin Catalog

​Core & Orchestration

​Memory & Knowledge

​Intelligence & Learning

​Code Quality & Testing

​Security & Compliance

​Architecture & Methodology

​DevOps & Observability

​Extensibility

​Domain-Specific

​Recommended Stacks

​Build Your Own Plugin

​Plugin SDK Components

​Plugin Hook Events

Build docs developers (and LLMs) love

Install from the Marketplace

Full Plugin Catalog

Core & Orchestration

Memory & Knowledge

Intelligence & Learning

Code Quality & Testing

Security & Compliance

Architecture & Methodology

DevOps & Observability

Extensibility

Domain-Specific

Recommended Stacks

Build Your Own Plugin

Plugin SDK Components

Plugin Hook Events