How csergey/ruflo works
Ruflo is an agent-orchestration harness for Claude Code and Codex: users submit work through its CLI or MCP interface, which routes tasks into coordinated agents that use memory and LLM providers; learning feeds successful patterns back into later work. The repository also contains a chat-oriented RuVocal UI, federation and graph-intelligence capabilities, and a goal-planning UI. The README documents the high-level orchestration flow; sampled source confirms MCP session handling, workflow execution, federation policy, and graph-reasoning components. Several core modules are indexed but unsampled, so their detailed internal calls are not inferred.
Main entry points: commands Specialist Agents · server.ts MCP Server · SwarmCoordinator.ts Swarm Coordinator · controller-registry.ts Agent Memory
Components 20
User Entry
- Ruflo CLI
bin/cli.js - MCP Server
v3/mcp/server.ts - MCP Sessions
v3/mcp/session-manager.ts
Agent Orchestration
- Task Router
v3/@claude-flow/cli/src/commands/route.ts - Swarm Coordinator
v3/src/coordination/application/SwarmCoordinator.ts - Workflow Engine
v3/src/task-execution/application/WorkflowEngine.ts - Specialist Agents
v3/@claude-flow/cli/src/commands - LLM Providers
v3/@claude-flow/providers/src/provider-manager.ts
Memory And Learning
- Agent Memory
v3/@claude-flow/memory/src/controller-registry.ts - Learning Loop
v3/@claude-flow/cli/src/memory/intelligence.ts - Embedding Service
v3/@claude-flow/embeddings/src/embedding-service.ts
Federation And Intelligence
- Federation Policy
v3/@claude-flow/plugin-agent-federation/src/application/policy-engine.ts - PII Protection
v3/@claude-flow/plugin-agent-federation/src/domain/services/pii-pipeline-service.ts - Graph Reasoning
plugins/ruflo-graph-intelligence/src/infrastructure/solver-bridge.ts - Signed Artifacts
plugins/ruflo-graph-intelligence/src/domain/signed-artifact.ts
Product Interfaces
- RuVocal Chat
ruflo/src/ruvocal/src/routes/+page.svelte - Conversation API
ruflo/src/ruvocal/src/routes/conversation/+server.ts - Text Generation
ruflo/src/ruvocal/src/lib/server/textGeneration/generate.ts - Goal Planner UI
v3/goal_ui/src/App.tsx
Other components
- User
Connections 19
- User → Ruflo CLI: submits tasks
README.md - Ruflo CLI → Task Router: routes work
- User → MCP Server: sends requests
README.md - MCP Server → MCP Sessions: manages sessions
v3/mcp/server.ts - MCP Server → Task Router: dispatches tools
- Task Router → Swarm Coordinator: coordinates agents
README.md - Swarm Coordinator → Workflow Engine: executes workflows
v3/src/task-execution/application/WorkflowEngine.ts - Swarm Coordinator → Specialist Agents: dispatches tasks
README.md - Specialist Agents → LLM Providers: requests inference
README.md - Specialist Agents → Agent Memory: uses memory
README.md - Agent Memory → Learning Loop: informs learning
README.md - Learning Loop → Specialist Agents: improves patterns
README.md - Agent Memory → Embedding Service: retrieves vectors
- User → RuVocal Chat: chats
- RuVocal Chat → Conversation API: requests conversations
- Conversation API → Text Generation: generates replies
- User → Goal Planner UI: plans goals
- Federation Policy → PII Protection: uses PII policy
v3/@claude-flow/plugin-agent-federation/src/application/policy-engine.ts - Graph Reasoning → Signed Artifacts: produces evidence