🌊 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
feat(console): drive.sh CONSOLE_DRIVE_INSTALL installs a plugin in the throwaway config (0.33.13)
ruv5c7b0da4f688
diff --git a/plugins/ruflo-console/.claude-plugin/plugin.json b/plugins/ruflo-console/.claude-plugin/plugin.jsonindex 5d564ff101..c5b06e10c4 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. The one network call it makes by itself is a daily read of the published plugin.json at github.com/ruvnet/ruflo to offer an update (Settings → Updates: ask, auto, or off); it installs only through Claude Code's own claude plugin update, and never a new major version without asking.",- "version": "0.33.11",+ "version": "0.33.13","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-console/README.md b/plugins/ruflo-console/README.mdindex 50b3605bac..82b85907c6 100644--- a/plugins/ruflo-console/README.md+++ b/plugins/ruflo-console/README.md@@ -20,13 +20,20 @@ Output is one `CALL <tool> <input>` and one `RESULT <tool> <text>` line per cons| 1 | no console tool call ran || 2 | usage error: bad level or an invalid `--expect` regex || 3 | at least one `--expect` regex (case-insensitive, repeatable) matched no `RESULT` |+| 4 | `CONSOLE_DRIVE_INSTALL` was set and the marketplace add or install failed |- **What it spends:** about $0.10 per run with haiku, hard-capped at $0.40 (`--max-budget-usd`). Use one to three runs, not a sweep.- **Isolated config:** the run uses a throwaway `CLAUDE_CONFIG_DIR` seeded with the level you ask for and confirm mode `auto` (your login is copied 0600 and shredded on exit), because `RUFLO_CONSOLE_CONTROL` can only lower the saved setting (ADR-450 T12) and your own saved mode would otherwise decide what a drive does.- **Why the level is capped:** the level is `read`, `write` or `manage`; `full` is rejected (exit 2). The run happens in a scratch project (`mktemp -d`), with Bash, Write and Edit disallowed, so a drive can never spend money or delete anything.- **Seeding:** `CONSOLE_DRIVE_SEED=<dir>` copies that directory into the scratch `.claude-flow/` first, for example a `claims/claims.json` to assert the claims view shows it.- **Skips cleanly:** without `RUFLO_E2E_LIVE=1` or a `claude` binary (on `PATH` or `$CLAUDE_BIN`) it prints `SKIP` and exits 0, so it is safe to call from CI.-- **Extra plugins:** any further arguments are added as `--plugin-dir`.+- **Extra plugins:** any further arguments are added as `--plugin-dir`. That loads a plugin but does not install it, so `claude plugin configure` cannot see it.+- **Installed plugin (for option rows):** `CONSOLE_DRIVE_INSTALL=<marketplace-dir>:<plugin>@<marketplace>` registers that directory as a marketplace and installs the plugin (user scope) inside the throwaway config only, then runs the drive; the Settings view can then read the plugin's options. Your real `~/.claude/plugins` and saved console settings are never touched, and `claude plugin update` is never run. Prints `INSTALLED <id>`; a bad value exits 2, a failed install exits 4.++```bash+CONSOLE_DRIVE_INSTALL="$PWD:ruflo-mods@ruflo" RUFLO_E2E_LIVE=1 bash plugins/ruflo-console/scripts/drive.sh \+ --expect 'Hide unused agent types' "$PWD/plugins/ruflo-console" read "Open view settings with chip mods, then console_state, and quote the ruflo-mods option rows."+```## Room and Modsdiff --git a/plugins/ruflo-console/hooks/version.ts b/plugins/ruflo-console/hooks/version.tsindex a003af81d3..4748920954 100644--- a/plugins/ruflo-console/hooks/version.ts+++ b/plugins/ruflo-console/hooks/version.ts@@ -2,4 +2,4 @@* The console's version, shown on the header so a person can tell which build is running. Kept equal to the plugin's manifest* (`.claude-plugin/plugin.json`); tests/version.spec.ts fails if the two drift.*/-export const CONSOLE_VERSION = '0.33.11'+export const CONSOLE_VERSION = '0.33.13'diff --git a/plugins/ruflo-console/scripts/drive.sh b/plugins/ruflo-console/scripts/drive.shindex ca95fa7d8a..617b43f741 100755--- a/plugins/ruflo-console/scripts/drive.sh+++ b/plugins/ruflo-console/scripts/drive.sh@@ -5,10 +5,13 @@# RUFLO_E2E_LIVE=1 bash drive.sh [--expect REGEX]... <console-plugin-dir> <read|write|manage> "<what to do>" [extra plugin dirs...]## Prints one CALL / RESULT line per console tool call (results cut at 4000 chars) and a final COST line.-# Exit: 0 ok · 1 no console tool call ran · 2 usage error (bad level, bad regex) · 3 an --expect matched no RESULT.+# Exit: 0 ok · 1 no console tool call ran · 2 usage error (bad level, bad regex, bad CONSOLE_DRIVE_INSTALL) · 3 an --expect matched no RESULT · 4 install failed.# Without RUFLO_E2E_LIVE=1 or a claude binary it prints SKIP and exits 0, so CI can call it everywhere. ~$0.10 per run (haiku, capped $0.40).# The level is capped at manage and the run happens in a scratch project, so a drive can never spend money or delete anything.# The saved control setting is seeded in an isolated, throwaway config dir (login copied 0600, shredded on exit), not taken from yours.+# CONSOLE_DRIVE_INSTALL=<marketplace-dir>:<plugin>@<marketplace> additionally registers that directory as a marketplace and installs the plugin+# (user scope) INSIDE the throwaway config only, so `claude plugin configure <plugin>@<marketplace>` (the Settings view's option rows) works.+# Your real ~/.claude plugins are never read or written. Exit 4 if the marketplace add or the install fails.# CONSOLE_DRIVE_SEED=<dir> copies that directory into the scratch .claude-flow before the run (seed claims, mods, ...).set -uEXPECT=(); POS=()@@ -25,6 +28,13 @@ case "$LEVEL" in read|write|manage) ;; *) echo "level must be read|write|managefor re in "${EXPECT[@]+"${EXPECT[@]}"}"; donode -e 'new RegExp(process.argv[1], "i")' "$re" 2>/dev/null || { echo "bad --expect regex: $re"; exit 2; }done+INSTALL_DIR=""; INSTALL_ID=""+if [[ -n "${CONSOLE_DRIVE_INSTALL:-}" ]]; then+ INSTALL_DIR="${CONSOLE_DRIVE_INSTALL%:*}"; INSTALL_ID="${CONSOLE_DRIVE_INSTALL##*:}"+ [[ "$INSTALL_DIR" != "$CONSOLE_DRIVE_INSTALL" && -d "$INSTALL_DIR" && "$INSTALL_ID" =~ ^[A-Za-z0-9._-]+@[A-Za-z0-9._-]+$ ]] \+ || { echo "CONSOLE_DRIVE_INSTALL must be <existing marketplace dir>:<plugin>@<marketplace>"; exit 2; }+ INSTALL_DIR="$(cd "$INSTALL_DIR" && pwd)"+fiCLAUDE="${CLAUDE_BIN:-$(command -v claude || echo "$HOME/.local/bin/claude")}"if [[ "${RUFLO_E2E_LIVE:-0}" != 1 || ! -x "$CLAUDE" ]]; thenecho "SKIP drive: set RUFLO_E2E_LIVE=1 with a claude binary on PATH or at \$CLAUDE_BIN"@@ -42,6 +52,13 @@ OUTJ="$SCRATCH/out.jsonl"; OUT="$SCRATCH"; CLI=truesource "$(dirname "${BASH_SOURCE[0]}")/e2e-lib.sh"make_config "$SCRATCH"trap 'shred_config 2>/dev/null; rm -rf "$CFG"' EXIT+if [[ -n "$INSTALL_ID" ]]; then+ # Only ever against the throwaway $CFG: CLAUDE_CONFIG_DIR is set on each call, never exported to the rest of the script.+ (cd "$SCRATCH" && CLAUDE_CONFIG_DIR="$CFG" "$CLAUDE" plugin marketplace add "$INSTALL_DIR" --scope user </dev/null >"$SCRATCH/install.txt" 2>&1 \+ && CLAUDE_CONFIG_DIR="$CFG" "$CLAUDE" plugin install "$INSTALL_ID" --scope user </dev/null >>"$SCRATCH/install.txt" 2>&1) \+ || { echo "install of $INSTALL_ID failed:"; tail -5 "$SCRATCH/install.txt"; exit 4; }+ echo "INSTALLED $INSTALL_ID (throwaway config only)"+fimkdir -p "$CFG/plugins/store"node -e 'require("node:fs").writeFileSync(process.argv[1], JSON.stringify({ "ai-prefs": { modelControl: process.argv[2], modelConfirm: "auto" } }))' \"$CFG/plugins/store/ruflo-console_inline-b43d4e31bb1a.json" "$LEVEL"diff --git a/plugins/ruflo-console/scripts/smoke.sh b/plugins/ruflo-console/scripts/smoke.shindex 27dda9a585..fd62da3d56 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.33.11"+step "1. plugin.json declares ruflo-console 0.33.13"grep -q '"name": "ruflo-console"' "$ROOT/.claude-plugin/plugin.json" \- && grep -q '"version": "0.33.11"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"+ && grep -q '"version": "0.33.13"' "$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" \