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

Checkpoint: File edits

rUv6578c0416e1b
diff --git a/v3/docs/adr/README.md b/v3/docs/adr/README.md
index 48c83c4c4f..ac0c312aaf 100644
--- a/v3/docs/adr/README.md
+++ b/v3/docs/adr/README.md
@@ -26,7 +26,7 @@ All ADRs are located in [`/v3/implementation/adrs/`](../../implementation/adrs/)
| [ADR-018](../../implementation/adrs/ADR-018-claude-code-integration.md) | Claude Code Integration | Complete |
| [ADR-019](../../implementation/adrs/ADR-019-headless-runtime-package.md) | Headless Runtime Package | Complete |
| [ADR-020](../../implementation/adrs/ADR-020-headless-worker-integration.md) | Headless Worker Integration | Complete |
-| [ADR-046](../../implementation/adrs/ADR-046-ruvflow-rebrand.md) | Dual Umbrella: claude-flow + ruvflow | Accepted |
+| [ADR-046](../../implementation/adrs/ADR-046-ruflo-rebrand.md) | Dual Umbrella: claude-flow + ruvflow | Accepted |
| [ADR-047](../../implementation/adrs/ADR-047-fast-mode-integration.md) | Fast Mode Integration | Proposed |
## Summary Documents
diff --git a/v3/implementation/adrs/ADR-046-ruvflow-rebrand.md b/v3/implementation/adrs/ADR-046-ruflo-rebrand.md
similarity index 71%
rename from v3/implementation/adrs/ADR-046-ruvflow-rebrand.md
rename to v3/implementation/adrs/ADR-046-ruflo-rebrand.md
index 742e8d567f..0178f96e7c 100644
--- a/v3/implementation/adrs/ADR-046-ruvflow-rebrand.md
+++ b/v3/implementation/adrs/ADR-046-ruflo-rebrand.md
@@ -1,4 +1,4 @@
-# ADR-046: Dual Umbrella Packages β€” claude-flow + ruvflow
+# ADR-046: Dual Umbrella Packages β€” claude-flow + ruflo
**Status:** Accepted
**Date:** 2026-02-07
@@ -7,7 +7,7 @@
## Context
-The umbrella package is published to npm as `claude-flow`. As the ecosystem grows and the product establishes its own identity, a second umbrella package `ruvflow` is introduced alongside the original.
+The umbrella package is published to npm as `claude-flow`. As the ecosystem grows and the product establishes its own identity, a second umbrella package `ruflo` is introduced alongside the original.
### Current State
@@ -24,13 +24,13 @@ The umbrella package is published to npm as `claude-flow`. As the ecosystem grow
1. **Brand Cohesion**: Aligns with the ruv ecosystem (ruv.io, @ruvector/*, ruv-swarm)
2. **Trademark Safety**: Removes potential trademark concerns with "Claude" in product name
3. **Product Identity**: Establishes independent product identity beyond Claude integration
-4. **Discoverability**: "ruvflow" is unique, memorable, and searchable
+4. **Discoverability**: "ruflo" is unique, memorable, and searchable
5. **Future Flexibility**: Enables the platform to support multiple AI backends without name confusion
6. **Zero Disruption**: Keeping `claude-flow` ensures no existing users are broken
## Decision
-Publish **two independent npm umbrella packages** β€” `claude-flow` (original) and `ruvflow` (new) β€” both backed by `@claude-flow/cli`.
+Publish **two independent npm umbrella packages** β€” `claude-flow` (original) and `ruflo` (new) β€” both backed by `@claude-flow/cli`.
### Package Architecture
@@ -38,8 +38,8 @@ Publish **two independent npm umbrella packages** β€” `claude-flow` (original) a
npm registry
β”œβ”€β”€ claude-flow ← original umbrella (bundles @claude-flow/cli)
β”‚ └── bin: claude-flow β†’ v3/@claude-flow/cli/bin/cli.js
-β”œβ”€β”€ ruvflow ← new umbrella (depends on @claude-flow/cli)
-β”‚ └── bin: ruvflow β†’ @claude-flow/cli/bin/cli.js
+β”œβ”€β”€ ruflo ← new umbrella (depends on @claude-flow/cli)
+β”‚ └── bin: ruflo β†’ @claude-flow/cli/bin/cli.js
└── @claude-flow/cli ← shared CLI implementation
```
@@ -47,11 +47,11 @@ npm registry
| Aspect | Before | After |
|--------|--------|-------|
-| npm packages | `claude-flow` only | `claude-flow` + `ruvflow` |
-| CLI binaries | `claude-flow` | `claude-flow` + `ruvflow` |
-| Install commands | `npx claude-flow@latest` | Both `npx claude-flow@latest` and `npx ruvflow@latest` |
-| README branding | "Claude-Flow" | "RuvFlow" (primary), "claude-flow" (supported) |
-| Product name | Claude-Flow | RuvFlow (with claude-flow alias) |
+| npm packages | `claude-flow` only | `claude-flow` + `ruflo` |
+| CLI binaries | `claude-flow` | `claude-flow` + `ruflo` |
+| Install commands | `npx claude-flow@latest` | Both `npx claude-flow@latest` and `npx ruflo@latest` |
+| README branding | "Claude-Flow" | "Ruflo" (primary), "claude-flow" (supported) |
+| Product name | Claude-Flow | Ruflo (with claude-flow alias) |
### What Stays the Same
@@ -69,7 +69,7 @@ npm registry
### Positive
1. **Zero Disruption**: Existing `claude-flow` users unaffected
-2. **Unified Brand**: New `ruvflow` package for the ruv ecosystem
+2. **Unified Brand**: New `ruflo` package for the ruv ecosystem
3. **Trademark Safety**: Users can choose the non-"Claude" branded package
4. **Dual Discovery**: Package discoverable under both names on npm
5. **Future Proof**: Can add non-Claude integrations without name confusion
@@ -94,22 +94,22 @@ npm registry
β”œβ”€β”€ package.json # name: "claude-flow" (original umbrella)
β”‚ # bin: claude-flow β†’ v3/@claude-flow/cli/bin/cli.js
β”‚ # bundles CLI files directly
-└── ruvflow/
- β”œβ”€β”€ package.json # name: "ruvflow" (new umbrella)
- β”‚ # bin: ruvflow β†’ ./bin/ruvflow.js
+└── ruflo/
+ β”œβ”€β”€ package.json # name: "ruflo" (new umbrella)
+ β”‚ # bin: ruflo β†’ ./bin/ruflo.js
β”‚ # depends on @claude-flow/cli
β”œβ”€β”€ bin/
- β”‚ └── ruvflow.js # thin wrapper, imports @claude-flow/cli
- └── README.md # RuvFlow-branded docs
+ β”‚ └── ruflo.js # thin wrapper, imports @claude-flow/cli
+ └── README.md # Ruflo-branded docs
```
### Phase 1: Preparation (This PR)
1. Create ADR-046 (this document)
2. Keep root `package.json` as `claude-flow` (original umbrella)
-3. Create `ruvflow/` directory with new umbrella package
-4. Update main README.md with RuvFlow branding
-5. Update install scripts to reference `ruvflow`
+3. Create `ruflo/` directory with new umbrella package
+4. Update main README.md with Ruflo branding
+5. Update install scripts to reference `ruflo`
### Phase 2: Publishing
@@ -124,10 +124,10 @@ npm publish --tag v3alpha
npm dist-tag add claude-flow@<version> latest
npm dist-tag add claude-flow@<version> alpha
-# 3. Publish ruvflow umbrella (new)
-cd /workspaces/claude-flow/ruvflow
+# 3. Publish ruflo umbrella (new)
+cd /workspaces/claude-flow/ruflo
npm publish --tag alpha
-npm dist-tag add ruvflow@<version> latest
+npm dist-tag add ruflo@<version> latest
```
### Phase 3: Ongoing
@@ -135,7 +135,7 @@ npm dist-tag add ruvflow@<version> latest
1. Both packages maintained indefinitely
2. Version numbers kept in sync
3. README shows both install options
-4. `ruvflow` promoted as primary in new documentation
+4. `ruflo` promoted as primary in new documentation
## Publishing Checklist
@@ -145,11 +145,11 @@ When publishing updates, **all three packages** must be published:
|-------|---------|---------|------|
| 1 | `@claude-flow/cli` | `npm publish --tag alpha` | alpha, latest |
| 2 | `claude-flow` | `npm publish --tag v3alpha` | v3alpha, alpha, latest |
-| 3 | `ruvflow` | `npm publish --tag alpha` | alpha, latest |
+| 3 | `ruflo` | `npm publish --tag alpha` | alpha, latest |
## Alternatives Considered
-### 1. Replace claude-flow with ruvflow (single package)
+### 1. Replace claude-flow with ruflo (single package)
**Pros:** Simpler, one package to maintain
**Cons:** Breaks existing users, loses download history
@@ -159,9 +159,9 @@ When publishing updates, **all three packages** must be published:
**Pros:** Matches ruv-swarm pattern
**Cons:** Inconsistent with @ruvector (no hyphen)
-**Decision:** Rejected - "ruvflow" is cleaner and matches ruvector pattern
+**Decision:** Rejected - "ruflo" is cleaner and matches ruvector pattern
-### 3. Rename internal packages too (@ruvflow/*)
+### 3. Rename internal packages too (@ruflo/*)
**Pros:** Complete rebrand
**Cons:** Major breaking change, complex migration, npm scope registration
@@ -169,7 +169,7 @@ When publishing updates, **all three packages** must be published:
### 4. Deprecate claude-flow
-**Pros:** Forces migration to ruvflow
+**Pros:** Forces migration to ruflo
**Cons:** Breaks existing users, bad developer experience
**Decision:** Rejected - both packages coexist permanently
@@ -179,7 +179,7 @@ When publishing updates, **all three packages** must be published:
```bash
# Recommended
-npx ruvflow@latest init --wizard
+npx ruflo@latest init --wizard
# Also works
npx claude-flow@latest init --wizard
@@ -192,13 +192,13 @@ No migration required. `claude-flow` continues to work. Optionally switch:
```bash
# Switch MCP server (optional)
claude mcp remove claude-flow
-claude mcp add ruvflow npx ruvflow@latest mcp start
+claude mcp add ruflo npx ruflo@latest mcp start
```
### For Contributors
1. Root `package.json` is the `claude-flow` umbrella
-2. `ruvflow/package.json` is the `ruvflow` umbrella
+2. `ruflo/package.json` is the `ruflo` umbrella
3. Internal imports remain `@claude-flow/*`
4. GitHub repo remains `ruvnet/claude-flow`
@@ -209,12 +209,12 @@ claude mcp add ruvflow npx ruvflow@latest mcp start
| Combined npm downloads | Maintain or grow | npm weekly stats (both packages) |
| GitHub stars | Maintain or grow | GitHub metrics |
| Issues from confusion | < 10 in 30 days | GitHub issues |
-| ruvflow adoption | 50%+ new installs in 90 days | npm stats |
+| ruflo adoption | 50%+ new installs in 90 days | npm stats |
## References
- GitHub Issue: #1101
-- npm: https://npmjs.com/package/ruvflow
+- npm: https://npmjs.com/package/ruflo
- npm: https://npmjs.com/package/claude-flow
- Related: ADR-017 (RuVector Integration)
@@ -224,18 +224,18 @@ claude mcp add ruvflow npx ruvflow@latest mcp start
| Context | Use |
|---------|-----|
-| npm packages | `ruvflow` and `claude-flow` (both lowercase) |
-| README title | "RuvFlow" (PascalCase) |
-| CLI binaries | `ruvflow` or `claude-flow` (both lowercase) |
-| In prose | "RuvFlow" (PascalCase) |
+| npm packages | `ruflo` and `claude-flow` (both lowercase) |
+| README title | "Ruflo" (PascalCase) |
+| CLI binaries | `ruflo` or `claude-flow` (both lowercase) |
+| In prose | "Ruflo" (PascalCase) |
### Command Examples
```bash
# New recommended style
-npx ruvflow@latest init
-npx ruvflow@latest agent spawn -t coder
-npx ruvflow@latest swarm init --topology hierarchical
+npx ruflo@latest init
+npx ruflo@latest agent spawn -t coder
+npx ruflo@latest swarm init --topology hierarchical
# Legacy style (still fully supported)
npx claude-flow@latest init