AgentToolHub
Skill

workflow-automation

workflow-automation — a Claude Code skill from ruvnet/ruflo

Features

  • ✓Enterprise-grade AI orchestration
  • ✓Multi-agent system deployment
  • ✓Self-learning and optimization
  • ✓Custom agent roles and types
  • ✓Coordinated swarm management
  • ✓Fault-tolerant consensus
  • ✓Rust-based WASM kernels
  • ✓Visit GitHub for more tools

Installation Guide

#### One-Line Install (Recommended)

bash
# curl-style installer with progress display
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

# Full setup (global + MCP + diagnostics)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash -s -- --full

<details>
<summary><b>Install Options</b></summary>

| Option | Description |
|--------|-------------|
| --global, -g | Install globally (npm install -g) |
| --minimal, -m | Skip optional deps (faster, ~15s) |
| --setup-mcp | Auto-configure MCP server for Claude Code |
| --doctor, -d | Run diagnostics after install |
| --no-init | Skip project initialization (init runs by default) |
| --full, -f | Full setup: global + MCP + doctor |
| --version=X.X.X | Install specific version |

Examples:

bash
# Minimal global install (fastest)
curl ... | bash -s -- --global --minimal

# With MCP auto-setup
curl ... | bash -s -- --global --setup-mcp

# Full setup with diagnostics
curl ... | bash -s -- --full

Speed:
| Mode | Time |
|------|------|
| npx (cached) | ~3s |
| npx (fresh) | ~20s |
| global | ~35s |
| --minimal | ~15s |

</details>

#### npm/npx Install

bash
# Quick start (no install needed)
npx ruflo@latest init

# Or install globally
npm install -g ruflo@latest
ruflo init

# With Bun (faster)
bunx ruflo@latest init

#### Install Profiles

| Profile | Size | Use Case |
|---------|------|----------|
| --omit=optional | ~45MB | Core CLI only (fastest) |
| Default | ~340MB | Full install with ML/embeddings |

bash
# Minimal install (skip ML/embeddings)
npm install -g ruflo@latest --omit=optional

<details>
<summary>🤖 <strong>OpenAI Codex CLI Support</strong> — Full Codex integration with self-learning</summary>

Ruflo supports both Claude Code and OpenAI Codex CLI via the @claude-flow/codex package, following the Agentics Foundation standard.

Quick Start for Codex

bash
# Initialize for Codex CLI (creates AGENTS.md instead of CLAUDE.md)
npx ruflo@latest init --codex

# Full Codex setup with all 137+ skills
npx ruflo@latest init --codex --full

# Initialize for both platforms (dual mode)
npx ruflo@latest init --dual

Platform Comparison

| Feature | Claude Code | OpenAI Codex |
|---------|-------------|--------------|
| Config File | CLAUDE.md | AGENTS.md |
| Skills Dir | .claude/skills/ | .agents/skills/ |
| Skill Syntax | /skill-name | $skill-name |
| Settings | settings.json | config.toml |
| MCP | Native | Via codex mcp add |
| Default Model | claude-sonnet | gpt-5.3 |

Key Concept: Execution Model

text
┌─────────────────────────────────────────────────────────────────┐
│  CLAUDE-FLOW = ORCHESTRATOR (tracks state, stores memory)       │
│  CODEX = EXECUTOR (writes code, runs commands, implements)      │
└─────────────────────────────────────────────────────────────────┘

Codex does the work. Claude-flow coordinates and learns.

Dual-Mode Integration (Claude Code + Codex)

Run Claude Code for interactive development and spawn headless Codex workers for parallel background tasks:

text
┌─────────────────────────────────────────────────────────────────┐
│  CLAUDE CODE (interactive)  ←→  CODEX WORKERS (headless)        │
│  - Main conversation         - Parallel background execution    │
│  - Complex reasoning         - Bulk code generation            │
│  - Architecture decisions    - Test execution                   │
│  - Final integration         - File processing                  │
└─────────────────────────────────────────────────────────────────┘
bash
# Spawn parallel Codex workers from Claude Code
claude -p "Analyze src/auth/ for security issues" --session-id "task-1" &
claude -p "Write unit tests for src/api/" --session-id "task-2" &
claude -p "Optimize database queries in src/db/" --session-id "task-3" &
wait  # Wait for all to complete

| Dual-Mode Feature | Benefit |
|-------------------|---------|
| Parallel Execution | 4-8x faster for bulk tasks |
| Cost Optimization | Route simple tasks to cheaper workers |
| Context Preservation | Shared memory across platforms |
| Best of Both | Interactive + batch processing |

Dual-Mode CLI Commands (NEW)

bash
# List collaboration templates
npx @claude-flow/codex dual templates

# Run feature development swarm (architect → coder → tester → reviewer)
npx @claude-flow/codex dual run --template feature --task "Add user auth"

# Run security audit swarm (scanner → analyzer → fixer)
npx @claude-flow/codex dual run --template security --task "src/auth/"

# Run refactoring swarm (analyzer → planner → refactorer → validator)
npx @claude-flow/codex dual run --template refactor --task "src/legacy/"

Pre-Built Collaboration Templates

| Template | Pipeline | Platforms |
|----------|----------|-----------|
| feature | architect → coder → tester → reviewer | Claude + Codex |
| security | scanner → analyzer → fixer | Codex + Claude |
| refactor | analyzer → planner → refactorer → validator | Claude + Codex |

MCP Integration for Codex

When you run init --codex, the MCP server is automatically registered:

bash
# Verify MCP is registered
codex mcp list

# If not present, add manually:
codex mcp add ruflo -- npx ruflo mcp start

Self-Learning Workflow

text
1. LEARN:   memory_search(query="task keywords") → Find similar patterns
2. COORD:   swarm_init(topology="hierarchical") → Set up coordination
3. EXECUTE: YOU write code, run commands       → Codex does real work
4. REMEMBER: memory_store(key, value, namespace="patterns") → Save for future

The Intelligence Loop (ADR-050) automates this cycle through hooks. Each session automatically:

  • Builds a knowledge graph from memory entries (PageRank + Jaccard similarity)

  • Injects ranked context into every route decision

  • Tracks edit patterns and generates new insights

  • Boosts confidence for useful patterns, decays unused ones

  • Saves snapshots so you can track improvement with node .claude/helpers/hook-handler.cjs stats

    • MCP Tools for Learning

    | Tool | Purpose | When to Use |
    |------|---------|-------------|
    | memory_search | Semantic vector search | BEFORE starting any task |
    | memory_store | Save patterns with embeddings | AFTER completing successfully |
    | swarm_init | Initialize coordination | Start of complex tasks |
    | agent_spawn | Register agent roles | Multi-agent workflows |
    | neural_train | Train on patterns | Periodic improvement |

    137+ Skills Available

    | Category | Examples |
    |----------|----------|
    | V3 Core | $v3-security-overhaul, $v3-memory-unification, $v3-performance-optimization |
    | AgentDB | $agentdb-vector-search, $agentdb-optimization, $agentdb-learning |
    | Swarm | $swarm-orchestration, $swarm-advanced, $hive-mind-advanced |
    | GitHub | $github-code-review, $github-workflow-automation, $github-multi-repo |
    | SPARC | $sparc-methodology, $sparc:architect, $sparc:coder, $sparc:tester |
    | Flow Nexus | $flow-nexus-neural, $flow-nexus-swarm, $flow-nexus:workflow |
    | Dual-Mode | $dual-spawn, $dual-coordinate, $dual-collect |

    Vector Search Details

  • Embedding Dimensions: 384

  • Search Algorithm: HNSW (sub-millisecond)

  • Similarity Scoring: 0-1 (higher = better)

    • - Score > 0.7: Strong match, use pattern
    - Score 0.5-0.7: Partial match, adapt
    - Score < 0.5: Weak match, create new

    </details>

    Basic Usage

    bash
    # Initialize project
npx ruflo@latest init

# Start MCP server for Claude Code integration
npx ruflo@latest mcp start

# Spawn a coding agent
npx ruflo@latest agent spawn -t coder --name my-coder

# Launch a hive-mind swarm with an objective
npx ruflo@latest hive-mind spawn "Implement user authentication"

# List available agent types
npx ruflo@latest agent list

    Upgrading

    bash
    # Update helpers and statusline (preserves your data)
npx ruflo@latest init upgrade

# Update AND add any missing skills/agents/commands
npx ruflo@latest init upgrade --add-missing

    The --add-missing flag automatically detects and installs new skills, agents, and commands that were added in newer versions, without overwriting your existing customizations.

    Claude Code MCP Integration

    Add ruflo as an MCP server for seamless integration:

    bash
    # Add ruflo MCP server to Claude Code
claude mcp add ruflo -- npx -y ruflo@latest mcp start

# Verify installation
claude mcp list

    Once added, Claude Code can use all 313 ruflo MCP tools directly:

  • swarm_init - Initialize agent swarms

  • agent_spawn - Spawn specialized agents

  • memory_search - Search patterns with HNSW vector search

  • hooks_route - Intelligent task routing

  • And 255+ more tools...

    • ---

    Reviews