# Flow Nexus Swarm

Cloud-based AI swarm deployment and event-driven workflow automation with Flow Nexus...

- Repository: https://github.com/ruvnet/RuVector (4653 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ruvnet/RuVector --skill flow-nexus-swarm -g -a claude-code -y`
Codex: `npx skills add ruvnet/RuVector --skill flow-nexus-swarm -g -a codex -y`
Cursor: `npx skills add ruvnet/RuVector --skill flow-nexus-swarm -g -a cursor -y`
Gemini CLI: `npx skills add ruvnet/RuVector --skill flow-nexus-swarm -g -a gemini-cli -y`

## Description

Cloud-based AI swarm deployment and event-driven workflow automation with Flow Nexus platform

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Flow Nexus Swarm & Workflow Orchestration

Deploy and manage cloud-based AI agent swarms with event-driven workflow automation, message queue processing, and intelligent agent coordination.

## Self-Learning Intelligence

Integrates with RuVector's Q-learning and vector memory for improved performance.
CLI: `node .claude/intelligence/cli.js stats`

## 📋 Table of Contents

1. [Overview](#overview)
2. [Swarm Management](#swarm-management)
3. [Workflow Automation](#workflow-automation)
4. [Agent Orchestration](#agent-orchestration)
5. [Templates & Patterns](#templates--patterns)
6. [Advanced Features](#advanced-features)
7. [Best Practices](#best-practices)

## Overview

Flow Nexus provides cloud-based orchestration for AI agent swarms with:

- **Multi-topology Support**: Hierarchical, mesh, ring, and star architectures
- **Event-driven Workflows**: Message queue processing with async execution
- **Template Library**: Pre-built swarm configurations for common use cases
- **Intelligent Agent Assignment**: Vector similarity matching for optimal agent selection
- **Real-time Monitoring**: Comprehensive metrics and audit trails
- **Scalable Infrastructure**: Cloud-based execution with auto-scaling

## Swarm Management

### Initialize Swarm

Create a new swarm with specified topology and configuration:

```javascript
mcp__flow-nexus__swarm_init({
  topology: "hierarchical", // Options: mesh, ring, star, hierarchical
  maxAgents: 8,
  strategy: "balanced" // Options: balanced, specialized, adaptive
})
```

**Topology Guide:**
- **Hierarchical**: Tree structure with coordinator nodes (best for complex projects)
- **Mesh**: Peer-to-peer collaboration (best for research and analysis)
- **Ring**: Circular coordination (best for sequential workflows)
- **Star**: Centralized hub (best for simple delegation)

The rest: https://github.com/ruvnet/RuVector/blob/HEAD/.claude/skills/flow-nexus-swarm/SKILL.md