🌊 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
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
chore(ruflo-console): 0.8.0 — labs, starts, marketplace install for the mods
ruv33eddc912bb1
diff --git a/README.md b/README.mdindex 4adf50460a..c8c7226f11 100644--- a/README.md+++ b/README.md@@ -54,6 +54,17 @@ User --> Ruflo (CLI/MCP) --> Router --> Swarm --> Agents --> Memory --> LLM Prov<sub>The <code>/ruflo</code> console running in Claude Code — <code>npx ruflo init</code>, restart Claude Code, then <code>/ruflo</code>.</sub>+**Install the mods from the ruflo marketplace** (Claude Code 2.1.287 or later; mods run with your account's permissions and are not sandboxed, so read the code first):++```text+/plugin marketplace add ruvnet/ruflo+/plugin install ruflo-console@ruflo+/plugin install ruflo-mods@ruflo+/reload-plugins+```++`ruflo-console` is the cockpit above, `ruflo-mods` routes prompts and enforces policy in-process, `ruflo-swarm` shows the swarm in a pane, and `ruflo-ruos` adds the ruOS status segment. Open `/plugin` to confirm they appear in the active mods line.+## Quick StartThere are **two different install paths** with very different surface areas. Pick based on what you need (#1744):diff --git a/plugins/ruflo-console/.claude-plugin/plugin.json b/plugins/ruflo-console/.claude-plugin/plugin.jsonindex 2160de11af..45bd1b711f 100644--- a/plugins/ruflo-console/.claude-plugin/plugin.json+++ b/plugins/ruflo-console/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-console","description": "ruflo's cockpit inside Claude Code and the one /ruflo command for every ruflo mod (function hooks, early access). Views: overview with health alerts, swarm topology graph, claims flow with TTL rings, federation map, plugin health matrix, learning curve and pipeline, MetaHarness radar and audit trend, memory, cost gauge, agent timeline, approvals queue, event stream, a main menu, an x.ruv.io federation board, an AI terminal (codex, claude or both in remembered sessions, streamed), Skills (npx skills), a Hive-Mind view, a MetaHarness lab, agent drill-down; a command palette for confirm-gated actions through the ruflo CLI; a band above the prompt. Reads ruflo's files and the CLI's local JSON; anything not measured reads n/a; no network by default.",- "version": "0.7.0",+ "version": "0.8.0","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-console/scripts/smoke.sh b/plugins/ruflo-console/scripts/smoke.shindex fdb132a718..90a50533ab 100755--- a/plugins/ruflo-console/scripts/smoke.sh+++ b/plugins/ruflo-console/scripts/smoke.sh@@ -11,9 +11,9 @@ step() { printf "→ %s ... " "$1"; }ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }-step "1. plugin.json declares ruflo-console 0.7.0"+step "1. plugin.json declares ruflo-console 0.8.0"grep -q '"name": "ruflo-console"' "$ROOT/.claude-plugin/plugin.json" \- && grep -q '"version": "0.7.0"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"+ && grep -q '"version": "0.8.0"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"step "2. hooks.json names exactly one module and no classic hook commands"grep -q '"modules": \["./register.ts"\]' "$HOOKS/hooks.json" && ! grep -q '"command"' "$HOOKS/hooks.json" \diff --git a/v3/docs/adr/ADR-407-ruflo-console-cockpit.md b/v3/docs/adr/ADR-407-ruflo-console-cockpit.mdindex b8a197ed0b..ff80808493 100644--- a/v3/docs/adr/ADR-407-ruflo-console-cockpit.md+++ b/v3/docs/adr/ADR-407-ruflo-console-cockpit.md@@ -182,6 +182,27 @@ The MetaHarness view (`views/metaharness.ts`, `views/mh-lab.ts`, `mh-lab.ts`) keThe audit-list probe now reads the fields the CLI emits (`key`, `startedAt`, `finishedAt`); before, the trend never had real points.+## 11a. Labs and starts (0.8.0)++Every ruflo capability is a view with buttons and fields, never a command to copy. Besides the first eleven areas, 0.8.0 adds keyless views reached from the main menu, the tab, or `/ruflo <name>`:++| View | What it covers | Notes |+|---|---|---|+| Memory Lab | browse, search, store, delete, AgentDB, embeddings, upkeep | two stores; the CLI reads one, the view warns |+| Cost & Budget | set a budget, where spend goes, the burn projection | the one write sends only `costBudgetUsd` to `claude plugin configure ruflo-mods@ruflo --values-stdin` |+| Security & Doctor, Performance | scans, paste check, policy, every doctor check; metrics, profile, benchmarks | scans write `.claude/security-scans`, so they ask first |+| Automation, Learning Lab | workflows, the 12 workers, autopilot, sessions, config, a task kanban; train, route, explain | per-row verbs come from the lists last read |+| Vector Lab | the ruvector CLI (pinned version): shared brain, RVF, workers, edge, hooks, identity | rvlite queries are MCP-only and go to the terminal typed, never run |+| Self-Evolution | flywheel receipts, ledger, lineage, the policy gate, the witness, Autogenous and rGi | promotion is never offered from the pane |+| Dev Tools | GitHub reads, diff analysis, agenticow, WASM, browser, terminal, providers, maintenance | GitHub rows are read-only |+| Skills (plus) | use without installing, preview, add to chosen agents, update, restore, sync | |++Empty sections offer the start (`init`, `daemon`, `swarm`, spawn, `hive-mind init`, `pretrain`, a task, a mission) as a confirm-gated button. The x.ruv.io board's rows are whole-row buttons: pressing a name runs its read, asks for its write, or focuses its field; unregister says why in the Result panel (the gateway has no leave endpoint).++Two layout rules came from live clicks that seemed dead: the Result panel sits at the top of the x.ruv.io board and the confirm row above every view's body, because in a tall view anything below the fold is never seen.++`tests/conformance.spec.ts` (`RUFLO_CONFORMANCE=1`) runs every action's argv against the real CLI's help and source, every `mcp exec` tool name against the registered tools, and the Vector Lab's argv against the ruvector CLI.+## 12. Release gatesA console change ships only when all of these hold: