ruflo 3.72.2 → 3.74.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +29 -21
  2. package/package.json +3 -2
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
  <!-- Try Ruflo — the 3 badges first-time visitors actually act on -->
8
8
  [![npm version (ruflo)](https://img.shields.io/npm/v/ruflo?label=npx%20ruflo&style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/ruflo)
9
9
  [![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
10
- [![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)
10
+ [![Star on GitHub](https://img.shields.io/github/stars/ruvnet/ruflo?style=for-the-badge&logo=github&color=gold)](https://github.com/ruvnet/ruflo)
11
11
  [![Follow @rUv on X](https://img.shields.io/badge/Follow-@rUv-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/rUv)
12
12
 
13
13
  <p align="center">
@@ -23,42 +23,49 @@
23
23
 
24
24
  <a id="start-here"></a>
25
25
 
26
- ## <img src="docs/assets/readme/icons/terminal.svg" width="32" height="32" alt=""> Get started with Ruflo
26
+ ## <img src="docs/assets/readme/icons/terminal.svg" width="32" height="32" alt=""> Get started in one command
27
27
 
28
- <img src="docs/assets/readme/icons/plugins.svg" width="28" height="28" alt=""> **Start in Claude Code** with core tools, the visual console and runtime mods. Requires Claude Code **2.1.287 or later**. Run inside Claude Code:
28
+ Run this in your project folder:
29
+
30
+ ```bash
31
+ npx ruflo@latest init
32
+ ```
33
+
34
+ Then open Claude Code in the same folder and give it a real task, for example:
29
35
 
30
36
  ```text
31
- /plugin marketplace add ruvnet/ruflo
32
- /plugin install ruflo-core@ruflo
33
- /plugin install ruflo-console@ruflo
34
- /plugin install ruflo-mods@ruflo
35
- /reload-plugins
36
- /ruflo
37
+ Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.
37
38
  ```
38
39
 
39
- From a terminal on Claude Code 2.1.292 or later, one command adds the marketplace and installs a plugin: `claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo`.
40
+ `init` adds ruflo's agents, hooks, memory and MCP server to the project, and Claude Code picks them up on its next start. Codex and other MCP clients work too: point them at `npx -y ruflo@latest mcp start`.
40
41
 
41
- **Core** provides foundation tools. **Console** opens the agent cockpit. **Mods** add routing and policy enforcement inside Claude Code. Mods run with your account's permissions; review their code before installing.
42
+ <p align="center"><img src="docs/assets/ruflo-console-tour.gif" width="720" alt="Looping recording of the ruflo console: overview, swarm view and missions in a sample project"></p>
42
43
 
43
- <img src="docs/assets/readme/icons/terminal.svg" width="28" height="28" alt=""> **Using Codex or another MCP enabled tool?** Use NPX for Ruflo project setup and connect your client to the Ruflo MCP server. Run the setup wizard in your project terminal:
44
+ [First useful task, step by step](docs/ruflo-explained.md) · [User guide](docs/USERGUIDE.md) · [Compare install paths](#quick-start)
44
45
 
45
- ```bash
46
- npx ruflo@latest init wizard
47
- ```
46
+ <details>
47
+ <summary><b>Other ways to install</b> (Claude Code plugins only, MCP-only clients, terminal UI)</summary>
48
48
 
49
- For clients that support local stdio MCP servers, configure **command** `npx` and **arguments** `["-y", "ruflo@latest", "mcp", "start"]`. The equivalent server command is:
49
+ **Claude Code plugins only.** This route installs core tools, the visual console and runtime mods, with no files added to your project. It needs Claude Code **2.1.287 or later**. Run inside Claude Code:
50
50
 
51
- ```bash
52
- npx -y ruflo@latest mcp start
51
+ ```text
52
+ /plugin marketplace add ruvnet/ruflo
53
+ /plugin install ruflo-core@ruflo
54
+ /plugin install ruflo-console@ruflo
55
+ /plugin install ruflo-mods@ruflo
56
+ /reload-plugins
57
+ /ruflo
53
58
  ```
54
59
 
55
- MCP exposes Ruflo tools to your client. The console and mods above are Claude Code integrations; hook support depends on the client.
60
+ From a terminal, on Claude Code 2.1.292 or later: `claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo`. Mods run with your account's permissions, so review their code before installing.
61
+
62
+ **Codex or another MCP client, without project setup.** Configure the **command** `npx` with the **arguments** `["-y", "ruflo@latest", "mcp", "start"]`. To set up a project interactively, run `npx ruflo@latest init wizard`.
56
63
 
57
- <img src="docs/assets/readme/icons/terminal.svg" width="28" height="28" alt=""> **Prefer a plain terminal? Optional.** The console also runs on its own, with no Claude Code: `npx ruflo tui` (add `--plain` to print one frame for scripts). It shows Overview, Cost, Swarm, Events and Missions, plus an optional AI page. [Terminal UI guide](docs/USERGUIDE.md#terminal-ui-optional)
64
+ **Plain terminal.** The console also runs on its own, without Claude Code: `npx ruflo tui`. Add `--plain` to print one frame for scripts. See the [terminal UI guide](docs/USERGUIDE.md#terminal-ui-optional).
58
65
 
59
66
  <p align="center"><img src="docs/assets/ruflo-tui-compact.svg" width="640" alt="Looping recording of the optional ruflo terminal UI with its pictures: Overview in the Classic BBS look, the Orbital look with its moving globe, and the Swarm graph, in a sample project"></p>
60
67
 
61
- [Compare install paths](#quick-start) · [Open the console](#console-walkthrough) · [User guide](docs/USERGUIDE.md)
68
+ </details>
62
69
 
63
70
  <div align="center">
64
71
 
@@ -484,6 +491,7 @@ Four docs for four audiences:
484
491
  |-----|-----------------|
485
492
  | **[Status](docs/STATUS.md)** | See what currently works — capability counts, test baselines, recent fixes, what's next. The *is-it-ready* doc. |
486
493
  | **[User Guide](docs/USERGUIDE.md)** | Daily reference — every command, every config flag, every plugin. The *how-do-I* doc. |
494
+ | **[Compare frameworks](docs/compare.md)** | Deciding between Ruflo, Claude Code built-in agents, CrewAI, LangGraph, or AutoGen. The *which-one-for-me* doc. |
487
495
  | **[MetaHarness Guide](docs/metaharness-user-guide.md)** | How to grade your agent setup, scan tool configs for security, detect changes between runs, and eject a project into a standalone agent toolkit. The *audit-my-setup* doc. |
488
496
  | **[Benchmarks](https://gist.github.com/ruvnet/298f8c668c8859b369f91734a0e9cbbe)** | v3.8.0 SOTA matrix vs LangGraph / AutoGen / CrewAI on darwin-arm64 + linux-x64. ruflo wins cold start, single turn, RSS by 1.3×–1953×. The *is-it-fast* doc. |
489
497
  | **[Verification](verification.md)** | Cryptographically prove your installed bytes match the signed witness — `ruflo verify`. The *trust-but-verify* doc. |
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "ruflo",
3
- "version": "3.72.2",
3
+ "mcpName": "io.github.ruvnet/ruflo",
4
+ "version": "3.74.0",
4
5
  "description": "Ruflo - Enterprise AI agent orchestration platform. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
5
6
  "main": "bin/ruflo.js",
6
7
  "type": "module",
@@ -40,7 +41,7 @@
40
41
  "package:rvf": "bash src/scripts/package-rvf.sh"
41
42
  },
42
43
  "dependencies": {
43
- "@claude-flow/cli": "3.72.2"
44
+ "@claude-flow/cli": "3.74.0"
44
45
  },
45
46
  "optionalDependencies": {},
46
47
  "overrides": {