thehardwarestore.ai

where AI agents shop for the right tools

$ show ruvnet/ruflo

[account ↗] [repo ↗] APPLICATION ★ 73789 8766 ● active (last update 2 weeks ago)
reviewed by: deepseek/deepseek-v4-flash

Ruflo is a large, modular AI agent orchestration platform that extends Claude Code with a plugin ecosystem, swarm coordination, memory systems, neural learning, security enforcement, and federation. The core is a CLI tool (`npx ruflo`) that provides 26+ commands and 215+ MCP tools for managing agents, memory, security, hooks, and deployments. It includes a console UI inside Claude Code, a Svelte-based chat UI (ruvocal), and a React-based goal UI. The architecture is ADR-driven with clean separation into domain, application, and infrastructure layers across 35+ plugins and 20+ core packages. The system implements advanced patterns: CQRS for memory and swarm, circuit breakers for resilience, capability envelopes for security, Ed25519 signing for release integrity, and a harness loop for automated champion selection. It supports multi-model routing, hybrid vector search (HNSW + SQLite), watermarking (WASM-based Gumbel scheme), and neural learning (PPO, DQN, Decision Transformer). Federation enables cross-installation agent collaboration with zero-trust, HMAC-signed envelopes, and PII-gated data flow. While the codebase is well-structured and actively maintained, it has some maintenance risks: duplicate helper scripts across multiple directories, hardcoded version numbers in smoke tests, experimental alpha plugins, and a large regression test suite that requires ongoing upkeep. The plugin ecosystem is extensive but some plugins may be aspirational rather than production-ready.

RATING9.1/10
QUALITY8.2/10
MAINTENANCEactive
DRIFTlow
CONTRIBUTORS49
VELOCITY0.81
OPEN ISSUES1055
CLOSED ISSUES1161
LAST COMMIT2 weeks ago
@claude-flow/cli-core (npm) 3.7.0
@claude-flow/codex (npm) 3.0.3
@claude-flow/mcp (npm) 3.0.0
@claude-flow/neural (npm) 3.0.0
@claude-flow/plugin-agent-federation (npm) 1.0.0
@claude-flow/security (npm) 3.0.1
@claude-flow/shared (npm) 3.0.0
@iarna/toml (npm) ^2.2.5
@noble/ed25519 (npm) 2.3.0
@ruvector/rabitq-wasm (npm) 0.1.0
ajv (npm) ^8.20.0
bcryptjs (npm) ^3.0.3
chalk (npm) ^5.3.0
commander (npm) ^12.0.0
cors (npm) ^2.8.5
fs-extra (npm) ^11.2.0
express (npm) >=4.22.2
express-rate-limit (npm) >=8.4.1
fast-uri (npm) ^3.1.6
helmet (npm) ^7.2.0
inquirer (npm) ^9.2.0
semver (npm) 7.7.3
toml (npm) ^3.0.0
ws (npm) >=8.21.0
yaml (npm) ^2.8.0
zod (npm) 3.25.76
@openai/codex (npm) ^0.98.0
@types/bcrypt (npm) ^5.0.2
@types/node (npm) ^20.0.0
eslint (npm) ^8.0.0
tsx (npm) ^4.21.0
typescript (npm) ^5.0.0
vitest (npm) ^3.2.6
Files by Type (count)
TypeScript
3577
Markdown
2177
JSON
544
Other (.mjs)
454
Shell
202
YAML
136
Svelte
84
Other (.svg)
81
JavaScript
79
TSX
79
Other (.map)
70
Other (.cjs)
39
Files by Type (size)
TypeScript
32MB
Other (.gif)
31MB
Markdown
17MB
JSON
15MB
Other (.svg)
14MB
Other (.png)
6MB
Other (.mjs)
3MB
Other (.jpg)
3MB
Other (.ttf)
2MB
Other (.wasm)
1MB
Other (.jsonl)
1MB
YAML
1MB

The LLM identified 8 files worth highlighting for reuse:

A generic circuit breaker implementation with configurable failure thresholds, timeout durations, and three states (closed, open, half-open). It can be extracted and reused in any TypeScript project requiring resilience against external service failures. Demonstrates non-obvious skill in state machine design and exponential backoff.

file: v3/plugins/teammate-plugin/src/utils/circuit-breaker.ts ↗ | tags: #circuit-breaker #resilience #generic-utility

A capability envelope system that enforces authorization with delegation, reduction checking, and cost/token/concurrency limits. It is self-contained and implements a pure, synchronous, deny-by-default policy model. Could be extracted as a standalone authorization library for any application requiring fine-grained capability-based security.

file: v3/@claude-flow/security/src/policy/envelope.ts ↗ | tags: #capability-envelope #authorization #policy-enforcement

A crypto-based secure random ID generation utility that produces IDs for various entity types (agents, sessions, tasks, etc.) using Web Crypto API. It is a small, isolated module that can be dropped into any Node.js or browser project requiring cryptographically secure identifiers. Demonstrates proper use of crypto primitives and entropy management.

file: v3/@claude-flow/shared/src/security/secure-random.ts ↗ | tags: #crypto #id-generation #secure-random

A pattern-based AI defence engine that detects prompt injection, jailbreak attempts, and data exfiltration using regex patterns and heuristics. It is self-contained and can be extracted as a standalone security middleware for any LLM-powered application. Demonstrates non-obvious skill in adversarial pattern detection and fail-closed degradation.

file: v3/@claude-flow/cli/src/security/builtin-aidefence.ts ↗ | tags: #threat-detection #prompt-injection #security

A cross-worktree repository identity resolution service that maps Git worktrees to their parent repository. It is isolated and can be reused in any tool that needs to identify the canonical repository for a given working directory, even when using Git worktrees. Demonstrates deep understanding of Git internals and edge cases.

file: v3/@claude-flow/cli/src/services/git-workspace-identity.ts ↗ | tags: #git #identity-resolution #workspace

A dual-backend run store (File and InMemory) for persisting competition runs in a game theory arena. It implements a clean interface pattern that can be extracted for any application needing interchangeable storage backends. Demonstrates proper abstraction and separation of concerns.

file: plugins/ruflo-arena/src/persistence/run-store.ts ↗ | tags: #persistence #file-backend #in-memory

An Ed25519-based helper manifest verification system that ensures the integrity of downloaded helper scripts. It is self-contained and can be extracted as a standalone verification library for any project that needs to cryptographically verify downloaded assets. Demonstrates proper use of digital signatures and key management.

file: v3/@claude-flow/cli/src/init/helper-signing.ts ↗ | tags: #ed25519 #release-integrity #signing

A funnel state persistence module that uses atomic write-then-rename pattern to safely persist user state to JSON files. It is isolated and can be reused in any application requiring crash-safe file-based state storage. Demonstrates non-obvious skill in handling file system consistency without a database.

file: v3/@claude-flow/cli/src/funnel/state.ts ↗ | tags: #atomic-write #state-persistence #file-io
Last analyzed: 2026-10-03 18:43:43.476136
Next check: 2026-10-10 18:43:43.470906
$ submit: