Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

docs: add twelve animated feature icons to README

rUv6dfc1fc00fbc
diff --git a/README.md b/README.md
index c7474d4884..671d3434a5 100644
--- a/README.md
+++ b/README.md
@@ -199,7 +199,7 @@ This adds slash commands and agent definitions. `ruflo-core` (installed above) d
</details>
-### CLI Install
+### <img src="docs/assets/readme/icons/terminal.svg" width="28" height="28" alt=""> CLI Install
**macOS / Linux / WSL / Git-Bash:**
@@ -223,7 +223,7 @@ npm install -g ruflo@latest
> πŸ’‘ **Windows users:** the `curl ... | bash` form needs a POSIX shell (Git-Bash, WSL, MSYS). The `npx ruflo@latest init wizard` line works natively in PowerShell and cmd. If you hit an `'bash' is not recognized` error, use the `npx` line instead β€” both end up running the same init flow.
-### MCP Server
+### <img src="docs/assets/readme/icons/network.svg" width="28" height="28" alt=""> MCP Server
```bash
# Add Ruflo as an MCP server in Claude Code
@@ -244,19 +244,19 @@ claude mcp add claude-flow -- npx ruflo@latest mcp start
| Capability | Description |
|------------|-------------|
-| πŸ€– **100+ Agents** | Specialized agents for coding, testing, security, docs, architecture |
-| πŸ“‘ **Comms Layer** | Zero-trust federation β€” agents across machines/orgs discover, authenticate, and exchange work securely |
-| 🐝 **Swarm Coordination** | Hierarchical, mesh, and adaptive topologies with consensus |
-| 🧠 **Self-Learning** | SONA neural patterns, ReasoningBank, trajectory learning |
-| πŸ’Ύ **Vector Memory** | HNSW-indexed AgentDB β€” measured ~1.9x faster at N=20k, ~3.2x–4.7x at N=5k vs brute force (recall@10 ~0.99); ANN wins above the crossover, ties/loses at small N. See [audit](docs/reviews/intelligence-system-audit-2026-05-29.md) + [`scripts/benchmark-intelligence.mjs`](scripts/benchmark-intelligence.mjs) |
-| ⚑ **Background Workers** | 12 auto-triggered workers (audit, optimize, testgaps, etc.) |
-| 🧩 **Plugin Marketplace** | 33 native Claude Code plugins + 21 npm plugins |
-| πŸ”Œ **Multi-Provider** | Claude, GPT, Gemini, Cohere, Ollama with smart routing |
-| πŸ›‘οΈ **Security** | AIDefence, input validation, CVE remediation, path traversal prevention |
-| 🌐 **Agent Federation** | Cross-installation agent collaboration with zero-trust security |
-| πŸ”¬ **[MetaHarness](docs/metaharness-user-guide.md)** | Audit your AI agent setup before you ship. Grade readiness (1-100), scan tool configs for security issues, snapshot the whole project to catch regressions over time, and find templates that match your repo. `ruflo eject` turns a ruflo project into a standalone agent toolkit with its own name. [Full guide](docs/metaharness-user-guide.md). |
-
-### Learning from experience
+| <img src="docs/assets/readme/icons/agents.svg" width="28" height="28" alt=""> **100+ Agents** | Specialized agents for coding, testing, security, docs, architecture |
+| <img src="docs/assets/readme/icons/network.svg" width="28" height="28" alt=""> **Comms Layer** | Zero-trust federation β€” agents across machines/orgs discover, authenticate, and exchange work securely |
+| <img src="docs/assets/readme/icons/swarm.svg" width="28" height="28" alt=""> **Swarm Coordination** | Hierarchical, mesh, and adaptive topologies with consensus |
+| <img src="docs/assets/readme/icons/learning.svg" width="28" height="28" alt=""> **Self-Learning** | SONA neural patterns, ReasoningBank, trajectory learning |
+| <img src="docs/assets/readme/icons/memory.svg" width="28" height="28" alt=""> **Vector Memory** | HNSW-indexed AgentDB β€” measured ~1.9x faster at N=20k, ~3.2x–4.7x at N=5k vs brute force (recall@10 ~0.99); ANN wins above the crossover, ties/loses at small N. See [audit](docs/reviews/intelligence-system-audit-2026-05-29.md) + [`scripts/benchmark-intelligence.mjs`](scripts/benchmark-intelligence.mjs) |
+| <img src="docs/assets/readme/icons/workers.svg" width="28" height="28" alt=""> **Background Workers** | 12 auto-triggered workers (audit, optimize, testgaps, etc.) |
+| <img src="docs/assets/readme/icons/plugins.svg" width="28" height="28" alt=""> **Plugin Marketplace** | 33 native Claude Code plugins + 21 npm plugins |
+| <img src="docs/assets/readme/icons/routing.svg" width="28" height="28" alt=""> **Multi-Provider** | Claude, GPT, Gemini, Cohere, Ollama with smart routing |
+| <img src="docs/assets/readme/icons/security.svg" width="28" height="28" alt=""> **Security** | AIDefence, input validation, CVE remediation, path traversal prevention |
+| <img src="docs/assets/readme/icons/federation.svg" width="28" height="28" alt=""> **Agent Federation** | Cross-installation agent collaboration with zero-trust security |
+| <img src="docs/assets/readme/icons/audit.svg" width="28" height="28" alt=""> **[MetaHarness](docs/metaharness-user-guide.md)** | Audit your AI agent setup before you ship. Grade readiness (1-100), scan tool configs for security issues, snapshot the whole project to catch regressions over time, and find templates that match your repo. `ruflo eject` turns a ruflo project into a standalone agent toolkit with its own name. [Full guide](docs/metaharness-user-guide.md). |
+
+### <img src="docs/assets/readme/icons/learning.svg" width="28" height="28" alt=""> Learning from experience
<p align="center"><img src="docs/assets/readme/learning-flow.svg" width="100%" alt="Recall, execute, evaluate, store, adapt and reuse: an illustrative agent learning cycle."></p>
diff --git a/docs/assets/readme/icons/agents.svg b/docs/assets/readme/icons/agents.svg
new file mode 100644
index 0000000000..38cb59c05b
--- /dev/null
+++ b/docs/assets/readme/icons/agents.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="agents"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#42e8ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="12" width="22" height="19" rx="5"/><path d="M20 7v5M5 19h4M31 19h4M15 26h10"/><g class="blink"><circle cx="15" cy="19" r="1.5"/><circle cx="25" cy="19" r="1.5"/></g></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/audit.svg b/docs/assets/readme/icons/audit.svg
new file mode 100644
index 0000000000..4f2e3fc201
--- /dev/null
+++ b/docs/assets/readme/icons/audit.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="audit"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#bb92ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><circle cx="18" cy="17" r="10"/><path d="m25 25 9 9"/><path class="signal" d="m12 17 4 4 8-9"/></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/federation.svg b/docs/assets/readme/icons/federation.svg
new file mode 100644
index 0000000000..01e9fde632
--- /dev/null
+++ b/docs/assets/readme/icons/federation.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="federation"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#42e8ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><circle cx="20" cy="20" r="14"/><ellipse class="pulse" cx="20" cy="20" rx="7" ry="14"/><path d="M6 20h28M9 12h22M9 28h22"/></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/learning.svg b/docs/assets/readme/icons/learning.svg
new file mode 100644
index 0000000000..b5d2b9eaa9
--- /dev/null
+++ b/docs/assets/readme/icons/learning.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="learning"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#bb92ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><path d="M20 8v25M19 9C9 2 4 16 10 20 3 30 13 36 19 30M21 9C31 2 36 16 30 20 37 30 27 36 21 30"/><path class="signal" d="M10 20h6l4-6 4 12 5-6h4"/></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/memory.svg b/docs/assets/readme/icons/memory.svg
new file mode 100644
index 0000000000..b71908096d
--- /dev/null
+++ b/docs/assets/readme/icons/memory.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="memory"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#42e8ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><ellipse cx="20" cy="9" rx="12" ry="5"/><path d="M8 9v22c0 7 24 7 24 0V9M8 20c0 7 24 7 24 0"/><path class="scan" d="M12 14h16"/></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/network.svg b/docs/assets/readme/icons/network.svg
new file mode 100644
index 0000000000..a3c5aea719
--- /dev/null
+++ b/docs/assets/readme/icons/network.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="network"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#42e8ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><circle cx="20" cy="20" r="4"/><g class="pulse"><path d="M12 12a11 11 0 0 0 0 16M28 12a11 11 0 0 1 0 16M7 7a18 18 0 0 0 0 26M33 7a18 18 0 0 1 0 26"/></g></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/plugins.svg b/docs/assets/readme/icons/plugins.svg
new file mode 100644
index 0000000000..cd0fbb1fd5
--- /dev/null
+++ b/docs/assets/readme/icons/plugins.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="plugins"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#bb92ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><path d="M13 7v8M27 7v8M10 15h20v5c0 8-20 8-20 0zM20 26v9"/><circle class="pulse" cx="20" cy="20" r="2"/></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/routing.svg b/docs/assets/readme/icons/routing.svg
new file mode 100644
index 0000000000..e2424a5c51
--- /dev/null
+++ b/docs/assets/readme/icons/routing.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="routing"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#42e8ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><path d="M7 20h11M18 20l10-10M18 20l10 10"/><g class="pulse"><circle cx="30" cy="9" r="3"/><circle cx="30" cy="31" r="3"/></g><circle cx="7" cy="20" r="3"/></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/security.svg b/docs/assets/readme/icons/security.svg
new file mode 100644
index 0000000000..f8b4a49354
--- /dev/null
+++ b/docs/assets/readme/icons/security.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="security"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#42e8ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><path d="M20 5 33 10v10c0 8-13 15-13 15S7 28 7 20V10z"/><path class="signal" d="m13 20 5 5 10-11"/></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/swarm.svg b/docs/assets/readme/icons/swarm.svg
new file mode 100644
index 0000000000..c96c95e39d
--- /dev/null
+++ b/docs/assets/readme/icons/swarm.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="swarm"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#42e8ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><g class="orbit"><path d="M20 7 32 27H8z"/><circle cx="20" cy="7" r="3"/><circle cx="32" cy="27" r="3"/><circle cx="8" cy="27" r="3"/></g><circle cx="20" cy="20" r="3"/></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/terminal.svg b/docs/assets/readme/icons/terminal.svg
new file mode 100644
index 0000000000..a2110e19b9
--- /dev/null
+++ b/docs/assets/readme/icons/terminal.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="terminal"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#42e8ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><rect x="5" y="8" width="30" height="24" rx="4"/><path d="m11 15 6 5-6 5"/><path class="blink" d="M21 25h7"/></g></svg>
\ No newline at end of file
diff --git a/docs/assets/readme/icons/workers.svg b/docs/assets/readme/icons/workers.svg
new file mode 100644
index 0000000000..3b423d12ff
--- /dev/null
+++ b/docs/assets/readme/icons/workers.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" viewBox="0 0 40 40" role="img" aria-label="workers"><style>.pulse{animation:p 3s ease-in-out infinite}.blink{animation:p 2s ease-in-out infinite}.orbit{transform-origin:20px 20px;animation:r 14s linear infinite}.signal{stroke-dasharray:50;animation:s 4s ease-in-out infinite}.scan{animation:t 3s ease-in-out infinite}@keyframes p{50%{opacity:.3}}@keyframes r{to{transform:rotate(360deg)}}@keyframes s{0%{stroke-dashoffset:50}65%,100%{stroke-dashoffset:0}}@keyframes t{50%{transform:translateY(11px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect width="40" height="40" rx="9" fill="#0b1726"/><g fill="none" stroke="#42e8ff" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><path class="pulse" d="m23 5-14 18h10l-2 12 14-18H21z"/></g></svg>
\ No newline at end of file