roforge-cli 0.3.3 → 0.3.4

package/bin/roforge.js

@@ -262,6 +262,33 @@ async function main() {
       return;
     }
 
+    case "install-plugin": {
+      const { PLUGINS, findPluginSource, installPlugin, pluginsDir } = await import("../src/install.js");
+      const which = (flags._pos && flags._pos[0]) || "bridge";
+      if (flags.list || flags.l) {
+        console.log(bold("Roblox Studio plugins folder:") + ` ${pluginsDir()}`);
+        return;
+      }
+      if (!PLUGINS[which]) {
+        console.error(red(`unknown plugin: ${which} (expected: ${Object.keys(PLUGINS).join(" | ")})`));
+        process.exit(1);
+      }
+      const src = findPluginSource(which);
+      if (!src) {
+        console.error(red("no built plugin found in this install."));
+        console.error(dim("  from a git clone: rojo build -o studio-bridge/dist/RoForgeBridge.rbxm studio-bridge/default.project.json"));
+        process.exit(1);
+      }
+      const { dest } = installPlugin(which);
+      console.log(bold("RoForge plugin installed") + dim(" — " + PLUGINS[which].desc + "\n"));
+      console.log(`  ${green("✓")} ${src}\n  →  ${dest}\n`);
+      console.log(bold("Next:"));
+      console.log("  1. start (or restart) Roblox Studio");
+      console.log("  2. File → Plugins → Manage Plugins — " + which + " is now listed");
+      console.log("  3. run `roforge studio` (or the TUI) and paste the printed token into the plugin dock");
+      return;
+    }
+
     case "pro": {
       const { queryProStatus, renderProStatus, probeBridge, startOwnBridge } = await import("../src/pro.js");
       const port = flags.port ? Number(flags.port) : cfg.bridge.port;
@@ -408,6 +435,7 @@ ${bold("Usage")}
   roforge tools               list all tools
   roforge login --provider <p> store a key (gemini|groq|openrouter|anthropic|openai)
   roforge providers           list providers, keys, and auto-routing order
+  roforge install-plugin      install the RoForge Bridge plugin into Studio
   roforge pro                 show RoForge Pro license status (needs Studio bridge)
   roforge analyze <file...>   run the official Luau analyzer on files
   roforge config [set k v]    show / set configuration
@@ -416,8 +444,9 @@ ${bold("Usage")}
 ${bold("How it connects to Studio")}
   1. Built-in MCP (recommended): Studio → File → Studio Settings → Beta Features →
      ${bold("MCP Server")} — roforge talks to it at http://localhost:3004/mcp automatically.
-  2. RoForge Bridge plugin: install studio-bridge/dist/RoForgeBridge.rbxm into Studio,
-     paste the bridge token (shown by ${bold("roforge studio")}) into the plugin.
+  2. RoForge Bridge plugin (not in the Roblox Toolbox — install from here):
+     ${bold("roforge install-plugin")}  →  Studio: File → Plugins (it's now listed)
+     then paste the bridge token (shown by ${bold("roforge studio")}) into the plugin dock.
 
 ${bold("Model providers (BYOK, zero backend)")}
   auto (default): first configured key wins, free tiers first:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roforge-cli",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "RoForge \u2014 Claude-Code-style local AI agent for Roblox Studio. BYOK, zero backend, zero dependencies.",
   "type": "module",
   "bin": {
@@ -30,6 +30,7 @@
   "files": [
     "bin",
     "src",
+    "dist",
     "demo",
     "README.md"
   ],

package/src/install.js

@@ -0,0 +1,72 @@
+// Plugin installation: copy a built .rbxm into the OS Roblox Studio plugins
+// folder so it appears under Studio's plugin page.
+//
+// Sources are resolved in this order:
+//   1. the npm package's bundled copy (cli/dist/<name>.rbxm) — works when
+//      installed via `npm i -g roforge-cli`
+//   2. the repo layout (<repoRoot>/studio-bridge/dist or <repoRoot>/client/dist)
+//      — works when running from a git clone
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { fileURLToPath } from "node:url";
+
+const here = path.dirname(fileURLToPath(import.meta.url)); // cli/src
+
+export const PLUGINS = {
+  bridge: {
+    dest: "RoForgeBridge.rbxm",
+    desc: "RoForge Bridge (loopback bridge driven by the roforge CLI — tools, vision, Pro status)",
+    repoRel: path.join("..", "..", "studio-bridge", "dist"),
+  },
+  client: {
+    dest: "RoForge.rbxm",
+    desc: "RoForge (in-Studio chat dock; standalone mode)",
+    repoRel: path.join("..", "..", "client", "dist"),
+  },
+};
+
+// Studio scans these folders for plugins.
+export function pluginsDir(env = process.env, platform = process.platform, home = os.homedir()) {
+  switch (platform) {
+    case "win32":
+      return path.join(env.LOCALAPPDATA || path.join(home, "AppData", "Local"), "Roblox", "Plugins");
+    case "darwin":
+      return path.join(home, "Documents", "Roblox", "Plugins");
+    default:
+      return path.join(env.XDG_DATA_HOME || path.join(home, ".local", "share"), "Roblox", "Plugins");
+  }
+}
+
+// Find the built .rbxm for `name`. Returns an absolute path or null.
+export function findPluginSource(name, { packageDir = path.join(here, "..") } = {}) {
+  const meta = PLUGINS[name];
+  if (!meta) return null;
+  const candidates = [
+    path.join(packageDir, "dist", meta.dest), // npm bundle
+    path.join(here, meta.repoRel, meta.dest), // git clone
+  ];
+  for (const c of candidates) {
+    if (fs.existsSync(c)) return c;
+  }
+  return null;
+}
+
+// Copy the plugin into the plugins folder. `destDir` overrides the target
+// (tests). Returns { src, dest }.
+export function installPlugin(name, { destDir } = {}) {
+  const meta = PLUGINS[name];
+  if (!meta) throw new Error(`unknown plugin: ${name} (expected: ${Object.keys(PLUGINS).join(" | ")})`);
+  const src = findPluginSource(name);
+  if (!src) {
+    throw new Error(
+      `no built plugin found (${meta.dest}). From a git clone run: ` +
+        `rojo build -o studio-bridge/dist/RoForgeBridge.rbxm studio-bridge/default.project.json`
+    );
+  }
+  const dir = destDir || pluginsDir();
+  fs.mkdirSync(dir, { recursive: true });
+  const dest = path.join(dir, meta.dest);
+  fs.copyFileSync(src, dest);
+  return { src, dest };
+}

package/src/session.js

@@ -60,7 +60,18 @@ export class Session {
     if (this.studioInfo.bridge) studio.push("The RoForge Bridge plugin is available (forge_* tools) — it connects when Studio is open and the bridge plugin is active.");
     const caps = (this.studioInfo.mcpCapture || []).map((n) => `studio_${n}`).join(", ");
     if (caps) studio.push(`Studio's MCP exposes vision tools (${caps}) — they return an image you can SEE; prefer them for visual checks.`);
-    if (!studio.length) studio.push("No Studio connection yet — forge_* tools will error until Studio is open with the RoForge Bridge plugin (or enable Studio's built-in MCP beta).");
+    if (!studio.length) {
+      studio.push(
+        "No Studio connection yet — forge_* tools will error until Studio is connected. " +
+          "If the user asks how to connect, give EXACTLY these steps (do not invent others — the RoForge " +
+          "Bridge plugin is NOT in the Roblox Toolbox): (1) run `roforge install-plugin` to install the " +
+          "bundled plugin into Studio's plugins folder, or in Studio use File → Plugins → Manage Plugins → " +
+          "Install File… with studio-bridge/dist/RoForgeBridge.rbxm from https://github.com/hacvilke/roforge; " +
+          "(2) open the RoForge Bridge dock and paste the bridge token shown by `roforge studio` (or in this " +
+          "TUI's /studio output); (3) the status turns green when connected. Alternative: enable Studio's " +
+          "built-in MCP (File → Studio Settings → Beta Features → MCP Server) — no plugin needed."
+      );
+    }
 
     return `You are RoForge, a local AI agent for Roblox development, running on the user's machine (Claude-Code-style). You work on two surfaces:
 

package/src/tui/tui.js

@@ -303,11 +303,14 @@ export class TUI {
     else lines.push(`${red("○")} studio MCP (built-in): not reachable @ ${this.session.cfg.mcpUrl}` + dim(" (File → Studio Settings → Beta Features → MCP Server)"));
     if (this.session.bridgeServer) {
       const b = this.session.bridgeServer;
-      lines.push(
-        b.connected
-          ? `${green("●")} bridge plugin: connected (http://${b.host}:${b.port})`
-          : `${yellow("○")} bridge plugin: waiting for Studio (http://${b.host}:${b.port})`
-      );
+      if (b.connected) {
+        lines.push(`${green("●")} bridge plugin: connected (http://${b.host}:${b.port})`);
+      } else {
+        lines.push(
+          `${yellow("○")} bridge plugin: waiting for Studio (http://${b.host}:${b.port})` +
+            dim(` — run \`roforge install-plugin\` if not installed; token to paste in the plugin dock: ${b.token}`)
+        );
+      }
     }
     return lines.join("\n");
   }