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: illustrate Ruflo origins with dated commit evidence (#4257)

rUv715da4690f18
diff --git a/README.md b/README.md
index 784c30fbfa..e48babaa46 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,10 @@
[![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![Star on GitHub](https://img.shields.io/github/stars/ruvnet/claude-flow?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/claude-flow)
+[![Original Claude Flow lineage. First commit June 2, 2025 by rUv. Inspect the evidence.](docs/assets/readme/badges/first-commit.svg)](docs/harness-origins.md)
+
+<sub>Created by <a href="https://github.com/ruvnet">Reuven Cohen · rUv</a>. <a href="docs/harness-origins.md">The origin story, illustrated · dated commits and prior context</a>.</sub>
+
<p align="center">
<a href="data/npm-downloads.latest.json"><img src="docs/assets/readme/badges/downloads.svg?v=mobile-readable-3" width="300" alt="Ecosystem npm downloads: 12.52M over 12 months through October 4, 2026"></a>
<br>
@@ -109,6 +113,14 @@ User → Ruflo (CLI/MCP) → Router → Swarm → Agents → Memory → LLM prov
> **New to Ruflo?** You don't need to learn 314 MCP tools or 26 CLI commands. After `init`, just use Claude Code normally — the hooks system automatically routes tasks, learns from successful patterns, and coordinates agents in the background.
+### An origin you can inspect
+
+[![Claude Flow to Ruflo: founding idea on June 2, 2025, orchestration source on June 10, and the continuing Ruflo lineage.](docs/assets/readme/harness-origins.svg)](docs/harness-origins.md)
+
+**Built by [Reuven Cohen (rUv)](https://github.com/ruvnet), originally as Claude Flow.** The [first commit, June 2, 2025](https://github.com/ruvnet/ruflo/commit/7c1f9402d70e7af56c01a879073cbac92564dc4e), describes a code orchestration layer for recursive agent cycles: Claude writes, edits, tests and improves. The [June 10 source snapshot](https://github.com/ruvnet/ruflo/tree/dba545f012ea92a2375a26332bbf3797495e93c9) adds orchestration, task scheduling, memory and terminal modules.
+
+A harness is the workbench around the model: it organizes tasks, carries context between steps and helps check results. **This establishes Ruflo's lineage, not a universal first across every Claude Code tool.** [See the illustrated explainer, exact commits and earlier ecosystem context](docs/harness-origins.md).
+
<details>
<summary><strong>📖 Background — where the name comes from</strong></summary>
diff --git a/docs/assets/readme/badges/first-commit.svg b/docs/assets/readme/badges/first-commit.svg
new file mode 100644
index 0000000000..167a28e688
--- /dev/null
+++ b/docs/assets/readme/badges/first-commit.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="440" height="76" viewBox="0 0 440 76" role="img" aria-labelledby="title desc"><title id="title">Claude Flow lineage: first commit June 2, 2025</title><desc id="desc">Ruflo began as claude-code-flow. Commit 7c1f9402 by rUv. Follow the surrounding link for dated source evidence.</desc><defs><linearGradient id="bg" x2="1" y2="1"><stop stop-color="#111c31"/><stop offset="1" stop-color="#070c16"/></linearGradient><linearGradient id="line"><stop stop-color="#51e5d0"/><stop offset="1" stop-color="#ad99ff"/></linearGradient></defs><style>text{font-family:Arial,Helvetica,sans-serif}.signal{stroke-dasharray:36 240;animation:travel 7s linear infinite}.pulse{animation:pulse 4s ease-in-out infinite}.float{animation:float 6s ease-in-out infinite}@keyframes travel{to{stroke-dashoffset:-552}}@keyframes pulse{0%,100%{opacity:.45}50%{opacity:1}}@keyframes float{0%,100%{transform:translateY(0)}50%{transform:translateY(-5px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect x=".5" y=".5" width="439" height="75" rx="12" fill="url(#bg)" stroke="#34445d"/><g stroke="#51e5d0" fill="#0d1726"><path d="M22 39H56M39 22V56"/><circle cx="22" cy="39" r="4"/><circle cx="56" cy="39" r="4"/><circle cx="39" cy="22" r="4"/><circle class="pulse" cx="39" cy="39" r="8"/></g><text x="76" y="24" fill="#b5c4d8" font-size="12" letter-spacing="1.3">ORIGINAL CLAUDE FLOW LINEAGE</text><text x="76" y="48" fill="#f1f6ff" font-size="19" font-weight="700">First commit · June 2, 2025</text><text x="76" y="65" fill="#51e5d0" font-size="11">7c1f9402 · by rUv · inspect the evidence</text><path class="signal" d="M12 73H428" fill="none" stroke="url(#line)" stroke-width="2"/></svg>
diff --git a/docs/assets/readme/harness-explained.svg b/docs/assets/readme/harness-explained.svg
new file mode 100644
index 0000000000..7bc9b0fcab
--- /dev/null
+++ b/docs/assets/readme/harness-explained.svg
@@ -0,0 +1,2 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="430" viewBox="0 0 960 430" role="img" aria-labelledby="title desc"><title id="title">What an agent harness does, in plain language</title><desc id="desc">A person sets a goal. The harness coordinates planning, Claude Code work and checks. Feedback can guide another attempt. Illustrative concept only; it does not show a live run or prove historical functionality.</desc><defs><linearGradient id="bg" x2="1" y2="1"><stop stop-color="#111c31"/><stop offset="1" stop-color="#070c16"/></linearGradient><linearGradient id="line"><stop stop-color="#51e5d0"/><stop offset="1" stop-color="#ad99ff"/></linearGradient></defs><style>text{font-family:Arial,Helvetica,sans-serif}.signal{stroke-dasharray:36 240;animation:travel 7s linear infinite}.pulse{animation:pulse 4s ease-in-out infinite}.float{animation:float 6s ease-in-out infinite}@keyframes travel{to{stroke-dashoffset:-552}}@keyframes pulse{0%,100%{opacity:.45}50%{opacity:1}}@keyframes float{0%,100%{transform:translateY(0)}50%{transform:translateY(-5px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect x="1" y="1" width="958" height="428" rx="24" fill="url(#bg)" stroke="#34445d"/><text x="40" y="48" fill="#51e5d0" font-size="14" letter-spacing="3">WHAT IS A HARNESS?</text><text x="40" y="92" fill="#f1f6ff" font-size="32" font-weight="700">The workbench around the model.</text><text x="40" y="124" fill="#b5c4d8" font-size="17">You set the goal. It organizes the work and keeps the feedback.</text><rect x="260" y="153" width="660" height="182" rx="20" fill="#101d30" stroke="#ad99ff"/><text x="282" y="180" fill="#ad99ff" font-size="13" letter-spacing="2">HARNESS · COORDINATION + CONTEXT + CHECKS</text><path d="M196 246H818" stroke="#34445d" stroke-width="3"/><path class="signal" d="M196 246H818" stroke="url(#line)" stroke-width="3" fill="none"/>
+<g fill="#13283a" stroke="#51e5d0"><rect x="40" y="205" width="156" height="82" rx="14"/><rect x="282" y="205" width="156" height="82" rx="14"/><rect x="512" y="205" width="156" height="82" rx="14"/><rect x="742" y="205" width="156" height="82" rx="14"/></g><g fill="#f1f6ff" text-anchor="middle" font-size="21" font-weight="700"><text x="118" y="240">Your goal</text><text x="360" y="240">Plan</text><text x="590" y="240">Do</text><text x="820" y="240">Check</text></g><g fill="#b5c4d8" text-anchor="middle" font-size="14"><text x="118" y="266">What should change?</text><text x="360" y="266">Divide the task</text><text x="590" y="266">Claude Code works</text><text x="820" y="266">Inspect the result</text></g><path d="M820 288V313H360V288" fill="none" stroke="#ad99ff" stroke-width="2"/><path class="signal" d="M820 288V313H360V288" fill="none" stroke="#51e5d0" stroke-width="2"/><circle class="pulse" cx="590" cy="313" r="5" fill="#51e5d0"/><text x="40" y="375" fill="#f1f6ff" font-size="18">Remember useful context. Try again when needed. Keep the person in control.</text><text x="40" y="404" fill="#b5c4d8" font-size="14">Concept illustration. Actual execution, permissions and checks depend on the installed integration.</text></svg>
diff --git a/docs/assets/readme/harness-origins.svg b/docs/assets/readme/harness-origins.svg
new file mode 100644
index 0000000000..6ec9ed9444
--- /dev/null
+++ b/docs/assets/readme/harness-origins.svg
@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="570" viewBox="0 0 960 570" role="img" aria-labelledby="title desc"><title id="title">From Claude Flow to Ruflo: an origin you can inspect</title><desc id="desc">June 2, 2025: rUv records the recursive orchestration idea. June 10: orchestration source is added. Today: Ruflo continues that lineage. Diagram is a historical illustration, not a runtime recording.</desc><defs><linearGradient id="bg" x2="1" y2="1"><stop stop-color="#111c31"/><stop offset="1" stop-color="#070c16"/></linearGradient><linearGradient id="line"><stop stop-color="#51e5d0"/><stop offset="1" stop-color="#ad99ff"/></linearGradient></defs><style>text{font-family:Arial,Helvetica,sans-serif}.signal{stroke-dasharray:36 240;animation:travel 7s linear infinite}.pulse{animation:pulse 4s ease-in-out infinite}.float{animation:float 6s ease-in-out infinite}@keyframes travel{to{stroke-dashoffset:-552}}@keyframes pulse{0%,100%{opacity:.45}50%{opacity:1}}@keyframes float{0%,100%{transform:translateY(0)}50%{transform:translateY(-5px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important}}</style><rect x="1" y="1" width="958" height="568" rx="24" fill="url(#bg)" stroke="#34445d"/><g fill="none" stroke="#22324b" opacity=".5"><path d="M40 140H920M40 180H920M40 220H920M40 260H920M40 300H920M40 340H920M40 380H920M40 420H920M40 460H920M40 500H920"/></g><text x="44" y="48" fill="#51e5d0" font-size="14" letter-spacing="3">THE ORIGIN IS IN THE COMMITS</text><text x="44" y="94" fill="#f1f6ff" font-size="34" font-weight="700">One idea. A continuing lineage.</text><text x="44" y="124" fill="#b5c4d8" font-size="17">Created by Reuven Cohen · rUv · github.com/ruvnet</text><path d="M130 249H830" stroke="#34445d" stroke-width="3"/><path class="signal" d="M130 249H830" stroke="url(#line)" stroke-width="3" fill="none"/>
+<g class="float"><path d="M95 197L130 178L165 197V237L130 256L95 237Z" fill="#102d34" stroke="#51e5d0" stroke-width="2"/><path d="M95 197L130 217L165 197M130 217V256" fill="none" stroke="#51e5d0"/><circle class="pulse" cx="130" cy="217" r="5" fill="#51e5d0"/></g>
+<g class="float" style="animation-delay:-2s" fill="#16243e" stroke="#80b7ff" stroke-width="2"><path d="M445 214L480 180L515 214L480 248Z"/><path d="M445 214L480 231L515 214M480 180V248"/><circle cx="445" cy="214" r="5"/><circle cx="515" cy="214" r="5"/></g>
+<g class="float" style="animation-delay:-4s" fill="none" stroke="#ad99ff" stroke-width="2"><ellipse cx="830" cy="217" rx="52" ry="18" transform="rotate(-30 830 217)"/><ellipse cx="830" cy="217" rx="52" ry="18" transform="rotate(30 830 217)"/><circle cx="830" cy="217" r="29"/><circle class="pulse" cx="830" cy="217" r="7" fill="#ad99ff"/></g>
+<g fill="#f1f6ff" font-size="22" font-weight="700"><text x="44" y="304">June 2, 2025</text><text x="365" y="304">June 10, 2025</text><text x="694" y="304">Ruflo today</text></g>
+<g fill="#b5c4d8" font-size="17"><text x="44" y="340">The founding idea</text><text x="44" y="368">Claude writes, edits, tests</text><text x="44" y="394">and improves in a loop.</text><text x="365" y="340">The system takes shape</text><text x="365" y="368">Agent roles, task queues,</text><text x="365" y="394">memory and terminal code.</text><text x="694" y="340">The lineage continues</text><text x="694" y="368">Claude Flow evolves</text><text x="694" y="394">into the Ruflo harness.</text></g>
+<g font-size="15" font-family="monospace" fill="#51e5d0"><text x="44" y="433">7c1f9402</text><text x="365" y="433">dba545f0</text><text x="694" y="433">Same repository history</text></g><rect x="30" y="468" width="900" height="73" rx="12" fill="#121f33" stroke="#34445d"/><text x="48" y="497" fill="#f1f6ff" font-size="17">A dated origin you can verify. An idea is different from a working release.</text><text x="48" y="523" fill="#b5c4d8" font-size="15">Commit links and limits of the historical claim are explained below.</text></svg>
diff --git a/docs/harness-origins.md b/docs/harness-origins.md
new file mode 100644
index 0000000000..5306c1600b
--- /dev/null
+++ b/docs/harness-origins.md
@@ -0,0 +1,71 @@
+# Claude Flow to Ruflo: the origin, in the commits
+
+**Created by [Reuven Cohen, known as rUv](https://github.com/ruvnet). First repository commit: June 2, 2025.** [rUv's website](https://ruv.io) · [Back to Ruflo](../README.md)
+
+![A three chapter animated history: June 2 founding idea, June 10 orchestration source, and the continuing Ruflo lineage.](assets/readme/harness-origins.svg)
+
+## The idea in everyday language
+
+Claude Code can work on code. An agent harness supplies a workbench around it: a way to divide a goal into tasks, carry useful context between steps, coordinate work and inspect the result before trying again.
+
+Think of a small software team. Someone plans, someone implements, someone checks. The harness organizes those steps; the model and its tools do the actual work. A plan or an agent record alone does not mean work has happened.
+
+![Animated concept diagram: a person sets the goal; the harness coordinates planning, Claude Code work and checks, with feedback returning to the plan.](assets/readme/harness-explained.svg)
+
+*Concept illustration, not a recording of a live run. Available behavior depends on the installed version, client, configuration and permissions.*
+
+## The dated record
+
+The dates below describe specific evidence, rather than assigning every modern Ruflo feature to its first day. Commit timestamps are normalized to UTC; the initial commit is also shown in Toronto time.
+
+| Date | Evidence you can open | What it establishes |
+| --- | --- | --- |
+| February 24, 2025 | [Anthropic introduces Claude Code](https://www.anthropic.com/news/claude-3-7-sonnet) | Claude Code is introduced in a limited research preview. This is platform context, not a Ruflo milestone. |
+| June 2, 2025, 21:24:20 UTC, 17:24:20 EDT | [Root commit `7c1f9402`](https://github.com/ruvnet/ruflo/commit/7c1f9402d70e7af56c01a879073cbac92564dc4e) · [Original README](https://github.com/ruvnet/ruflo/blob/7c1f9402d70e7af56c01a879073cbac92564dc4e/README.md) | rUv starts `claude-code-flow`. Its README describes code orchestration and recursive cycles of writing, editing, testing and optimization. The tree contains a README and license, not a working implementation. |
+| June 10, 2025, 03:48:41 UTC | [Commit `dba545f0`](https://github.com/ruvnet/ruflo/commit/dba545f012ea92a2375a26332bbf3797495e93c9) · [Source snapshot](https://github.com/ruvnet/ruflo/tree/dba545f012ea92a2375a26332bbf3797495e93c9/src) | The repository contains orchestration, task scheduling, memory, terminal management, CLI and MCP modules. This is source evidence, not a retrospective runtime or coverage certification. |
+| Continuing lineage | [Current repository history](https://github.com/ruvnet/ruflo/commits/main/) | The project now called Ruflo retains its Claude Flow history. Current capabilities should be checked against current documentation and tests. |
+
+## What was already present in the early design?
+
+| Idea | Plain language | Pinned historical evidence |
+| --- | --- | --- |
+| Recursive work cycles | Write something, inspect it and improve it in another pass. | [June 2 README](https://github.com/ruvnet/ruflo/blob/7c1f9402d70e7af56c01a879073cbac92564dc4e/README.md) |
+| Agent roles | Give different kinds of work different responsibilities. | [June 10 agent command source](https://github.com/ruvnet/ruflo/blob/dba545f012ea92a2375a26332bbf3797495e93c9/src/cli/commands/agent.ts) |
+| Tasks, context and tool access | Organize the queue, retain useful information and expose tools. | [June 10 README and architecture](https://github.com/ruvnet/ruflo/blob/dba545f012ea92a2375a26332bbf3797495e93c9/README.md) |
+| Managed terminal sessions | Give work a terminal session and manage its lifecycle. | [June 10 terminal manager](https://github.com/ruvnet/ruflo/blob/dba545f012ea92a2375a26332bbf3797495e93c9/src/terminal/manager.ts) |
+
+**Read the code as well as the descriptions.** For example, the June 10 `agent spawn` CLI creates and prints an agent profile and says a running instance is required. That command alone is not evidence that it launched a working Claude Code agent. Historical README claims about coverage or completeness are not independently verified by this timeline.
+
+## Prior art and the scope of the claim
+
+The strongest supported statement is: **Ruflo's Claude Flow lineage begins with rUv's June 2, 2025 commit describing recursive agent orchestration.**
+
+That is different from proving the first public release, the first working implementation, or being the first Claude Code harness in the world. Git author and committer dates can be set by contributors. They identify the recorded history, not independently witnessed publication times.
+
+There is earlier public ecosystem context. [Claude Squad issue 56, opened April 6, 2025](https://github.com/smtg-ai/claude-squad/issues/56), discusses launching Claude Code across repositories, and a collaborator describes using it in multiple repositories that day. This predates Ruflo's root commit and makes an unrestricted claim to the first Claude Code coordination tool untenable. It does not establish that the two projects had identical architectures or capabilities.
+
+Here, **prior art** means dated technical context and disclosed ideas. It is not a patent novelty opinion, a claim of copying, or an exhaustive survey. A narrower priority claim would need an explicit feature definition, a comparable working source snapshot and a broader search of earlier systems.
+
+## Verify the origin yourself
+
+In a full clone of this repository:
+
+```bash
+# Show every root reachable from the current branch.
+git rev-list --max-parents=0 HEAD
+
+# Inspect the recorded author, committer and timestamps.
+git show --no-patch --format=fuller 7c1f9402d70e7af56c01a879073cbac92564dc4e
+
+# See exactly what existed on the first day.
+git ls-tree --name-only 7c1f9402d70e7af56c01a879073cbac92564dc4e
+git show 7c1f9402d70e7af56c01a879073cbac92564dc4e:README.md
+
+# Compare that with the early orchestration source.
+git show --stat dba545f012ea92a2375a26332bbf3797495e93c9
+git show dba545f012ea92a2375a26332bbf3797495e93c9:src/cli/commands/agent.ts
+```
+
+**Acceptance check:** the root is `7c1f9402d70e7af56c01a879073cbac92564dc4e`, its recorded date is June 2, 2025, and its tree has `LICENSE` and `README.md`. Open the pinned source links to distinguish the original idea from later implementation.
+
+The SVGs use local assets, accessible titles and descriptions, readable static frames and a reduced motion setting. The README supplies clickable wrappers because GitHub displays SVG images without interactive links inside them. No JavaScript or external fonts are required.