Plugins

Plugins

Ruflo ships with 21+ native plugins and supports custom plugin development.

---

Native Plugins

Core & Orchestration

Plugin	Latest	Purpose
ruflo-core	v3.10	Foundation — CLI, MCP server, plugin discovery
ruflo-swarm	v3.10	Multi-agent coordination with anti-drift
ruflo-autopilot	v3.10	Autonomous task loops
ruflo-loop-workers	v3.10	Background workers on timers
ruflo-workflows	v3.10	Reusable multi-step task templates
ruflo-federation	v3.10	Agent comms across machines (secure)

Memory & Knowledge

Plugin	Latest	Purpose
ruflo-agentdb	v3.10	Vector database (HNSW, 150x faster)
ruflo-rag-memory	v3.10	Hybrid search (semantic, graph, diversity)
ruflo-rvf	v3.10	Persistent agent memory (RVF format)
ruflo-ruvector	v3.10	GPU-accelerated search, Graph RAG
ruflo-knowledge-graph	v3.10	Entity relationships and traversal

Intelligence & Learning

Plugin	Latest	Purpose
ruflo-intelligence	v3.10	Learn from past successes (SONA, MoE)
ruflo-graph-intelligence	v3.10	Sublinear graph reasoning (ADR-130)
ruflo-daa	v3.10	Dynamic agent behavior adaptation
ruflo-ruvllm	v3.10	Local LLM routing (Ollama, Llama.cpp)
ruflo-goals	v3.10	Long-horizon goal planning and tracking

Code Quality & Testing

Plugin	Latest	Purpose
ruflo-testgen	v3.10	Coverage gap analysis and test generation
ruflo-browser	v3.10	Browser automation (Playwright)
ruflo-jujutsu	v3.10	Git diff analysis, risk scoring
ruflo-docs	v3.10	Auto-generate documentation

Security & Compliance

Plugin	Latest	Purpose
ruflo-security-audit	v3.10	Vulnerability scanning, CVE detection
ruflo-aidefence	v3.10	PII detection, prompt injection blocking

Architecture & Methodology

Plugin	Latest	Purpose
ruflo-adr	v3.10	Architecture Decision Record lifecycle
ruflo-ddd	v3.10	Domain-Driven Design scaffolding
ruflo-sparc	v3.10	SPARC 5-phase methodology

DevOps & Observability

Plugin	Latest	Purpose
ruflo-migrations	v3.10	Safe database schema management
ruflo-observability	v3.10	Logs, traces, metrics (all in one)
ruflo-cost-tracker	v3.10	Token usage, budgets, cost alerts

Extensibility

Plugin	Latest	Purpose
ruflo-agent	v3.10	Local (WASM) + cloud (Anthropic Managed) agents
ruflo-plugin-creator	v3.10	Scaffold and publish custom plugins

---

Install a Plugin

Via CLI

npx ruflo@latest plugins install ruflo-testgen

Via Claude Code Plugin Marketplace

/plugin install ruflo-testgen@ruflo

---

List Installed Plugins

npx ruflo@latest plugins list

Output:

Installed Plugins (21):
  ruflo-core ✓
  ruflo-swarm ✓
  ruflo-testgen ✓
  ...

Available for Install (8):
  ruflo-neural-trader
  ruflo-market-data
  ruflo-iot-cognitum

---

Enable/Disable

# Disable (plugin remains installed, just not loaded)
npx ruflo@latest plugins disable ruflo-testgen

# Enable
npx ruflo@latest plugins enable ruflo-testgen

# Uninstall
npx ruflo@latest plugins uninstall ruflo-testgen

---

Create a Custom Plugin

Scaffold

npx ruflo@latest plugins create my-plugin

This creates:

my-plugin/
  ├── plugin.json           # Plugin metadata
  ├── src/
  │   ├── index.ts          # Main export
  │   ├── commands/         # Slash commands
  │   ├── skills/           # Skills (auto-loaded)
  │   └── agents/           # Agent definitions
  ├── tests/
  ├── package.json
  └── README.md

Plugin Anatomy

plugin.json:

{
  "id": "ruflo-my-plugin",
  "version": "1.0.0",
  "description": "My custom plugin",
  "author": "your-name",
  "license": "MIT",
  "commands": [
    {
      "name": "my-command",
      "description": "What it does",
      "usage": "my-command [options]"
    }
  ],
  "skills": [
    {
      "name": "my-skill",
      "trigger": "user asks for X"
    }
  ],
  "agents": ["my-agent"],
  "hooks": ["post-task"],
  "permissions": ["memory", "swarm"]
}

Implement a Command

src/commands/my-command.ts:

export const myCommand = {
  name: "my-command",
  handler: async (args: string[]) => {
    console.log("Executing my-command with args:", args);
    return "Command executed";
  }
};

Implement a Skill

src/skills/my-skill.md:

---
name: my-skill
trigger: When the user asks to [do something]
---

# My Skill

You can now do X by calling:

```bash
npx ruflo@latest my-command --option value

### Implement a Custom Agent

**src/agents/my-agent.ts**:
```typescript
import { Agent } from "@claude-flow/cli";

export class MyAgent extends Agent {
  name = "my-agent";
  type = "specialist";
  
  async execute(prompt: string) {
    // Implement custom logic
    return "Agent result";
  }
}

---

Publish Your Plugin

Step 1: Test Locally

npx ruflo@latest plugins install ./my-plugin
npx ruflo@latest my-command --test

Step 2: Publish to npm

cd my-plugin
npm publish --access public

Your plugin must:

• Start with ruflo- prefix
• Include plugin.json in the root
• Export main class/functions from src/index.ts

Step 3: Submit to Registry

After publishing to npm, open a PR on the Ruflo repo to add your plugin to the plugin registry.

---

Plugin Registry

The registry is maintained on IPFS via Pinata. Current CID stored in:

v3/@claude-flow/cli/src/plugins/store/discovery.ts

Browse the registry:

curl -s "https://gateway.pinata.cloud/ipfs/<CID>" | jq '.plugins[]'

---

Plugin Architecture

Plugins can:

• Add commands — User-facing CLI operations
• Add skills — Teachable capabilities (slash commands in Claude Code)
• Add agents — New agent types for swarms
• Add hooks — Listen to lifecycle events
• Add MCP tools — Extend the 314-tool ecosystem
• Add workers — Background task runners

All plugins share:

• memory_* tools (store, search, retrieve)
• swarm_* tools (orchestration)
• hooks system (learning)
• agentdb_* tools (graph intelligence)

---

Plugin Dependencies

Plugins can depend on other plugins:

{
  "dependencies": {
    "ruflo-core": "^3.10.0",
    "ruflo-swarm": "^3.10.0"
  }
}

---

Troubleshooting

Plugin fails to load

npx ruflo@latest doctor --fix

Checks:

• Plugin integrity
• Dependency satisfaction
• Permission conflicts
• API key availability

Plugin version mismatch

npx ruflo@latest plugins list --verbose

Shows compatibility status. Update or downgrade as needed.

Remove plugin residue

npx ruflo@latest plugins disable my-plugin
rm -rf ~/.ruflo/plugins/my-plugin

---

Plugin Resources

• Plugin Creator: ruflo-plugin-creator (scaffold, validate, publish)
• Documentation: Plugins Guide
• Examples: See existing plugins

---

Ruflo v3.10.1 · 21+ native plugins · GitHub