mirror of
https://github.com/ruvnet/ruflo.git
synced 2026-10-23 20:07:01 +09:00
Clone
1
Plugins
ruv edited this page 2026-05-25 10:01:20 -04:00
Table of Contents
- Plugins
- Native Plugins
- Core & Orchestration
- Memory & Knowledge
- Intelligence & Learning
- Code Quality & Testing
- Security & Compliance
- Architecture & Methodology
- DevOps & Observability
- Extensibility
- Install a Plugin
- List Installed Plugins
- Enable/Disable
- Create a Custom Plugin
- Publish Your Plugin
- Plugin Registry
- Plugin Architecture
- Plugin Dependencies
- Troubleshooting
- Plugin Resources
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.jsonin 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)hookssystem (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
Getting Started
Reference
Architecture
Advanced
Operations
Ruflo v3.10.1 · npm · GitHub · Benchmarks