ruflo

Source#

• Repository: ruvnet/ruflo
• Last source update: 2026-05-10
• Last verified: 2026-05-10

Tags#

Integration notes#

Repository is focused on tool/server interoperability; wrap in bounded worker contracts for production use.

worker.md example#

Starter worker.md contract mapped from this registry entry. Copy this file and adapt schemas, constraints, and statuses for your task.

---
id: ruflo-repo-derived-worker
name: ruflo Repo-Derived Worker
version: 1.0.0
source_registry_url: https://worker.md/registry/ruflo/
source_repository: https://github.com/ruvnet/ruflo
repository_default_branch: main
repository_language: TypeScript
repository_license: MIT
repository_updated_at: 2026-05-10
worker_mode: workflow-automation-worker
derivation_method: github_repository_metadata_plus_raw_readme
derivation_confidence: 0.95
derived_on: 2026-05-10
tags:
  - agentic-ai
  - agentic-framework
  - agentic-rag
  - agentic-workflow
  - agents
  - ai-agent
---

# ruflo Repo-Derived Worker

## Repo-derived summary
- Registry summary: 🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features    enterprise-grade arc...
- Repository description: 🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features    enterprise-grade architecture, self-learning swarm intelligence, RAG integration, and native Claude Code / Codex Integration
- Stars (snapshot): 48,005
- Primary language: TypeScript
- Worker mode classification: workflow-automation-worker

## Extracted from
- https://github.com/ruvnet/ruflo
- https://github.com/ruvnet/ruflo/blob/main/README.md
- https://cognitum.one/?RuFlo
- https://github.com/ruvnet/RuVector/tree/main/examples/ruvLLM
- https://github.com/ruvnet/ruflo/issues/1689

## Evidence notes (from repository text)
- README summary paragraph: [![Ruflo Banner](ruflo/assets/ruflo-small.jpeg)](https://flo.ruv.io/)
- **Multi-agent AI orchestration for Claude Code**
- Self-Learning / Self-Optimizing Agent Architecture
- User --> Ruflo (CLI/MCP) --> Router --> Swarm --> Agents --> Memory --> LLM Providers
- | What it gives you | Slash commands + a few skills + agent definitions per-plugin | Full Ruflo loop — 98 agents, 60+ commands, 30 skills, MCP server, hooks, daemon |
- | MCP server registered | **No** (`memory_store`, `swarm_init`, etc. unavailable to Claude) | Yes |

## Installation hints found in README
- `npm install -g ruflo@latest`
- `npm install && npm run dev`.`

## worker.md contract (derived starter)
Purpose: Execute one automation workflow step in a bounded worker run.

### Input schema
```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "run_id",
    "trigger",
    "step"
  ],
  "properties": {
    "run_id": {
      "type": "string"
    },
    "trigger": {
      "type": "object"
    },
    "step": {
      "type": "string"
    }
  }
}
```

### Output schema
```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "run_id",
    "step",
    "status",
    "artifacts"
  ],
  "properties": {
    "run_id": {
      "type": "string"
    },
    "step": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "ok",
        "retryable_error",
        "invalid_request",
        "invalid_output"
      ]
    },
    "artifacts": {
      "type": "array"
    }
  }
}
```

### Constraints
- timeout_seconds: 30
- max_attempts: 2
- idempotency_key: run_id
- status_enum: [ok, retryable_error, invalid_request, invalid_output]
- notes: adapt to concrete APIs/classes documented in this repository before production use

## How this should be used
1. Treat this file as a repo-derived starter profile, not a claim of an official repository API contract.
2. Replace schemas with exact interfaces from code/docs you adopt.
3. Keep execution bounded and auditable using worker protocol constraints.

How to use#

• Save this as a worker spec file (for example: ruflo-my-task.worker.md).
• Replace the input/output schemas and purpose with your real bounded task.
• Enforce schema validation + timeout + retry policy in your runtime before production use.

Citation#

Reference URL: https://worker.md/registry/ruflo/

Source URL: https://github.com/ruvnet/ruflo