getprismo 0.1.36 → 0.1.38

package/lib/prismo-dev/agent.js

@@ -341,6 +341,24 @@ module.exports = function createAgent(deps) {
       results.push({ id: action.id, label: action.label, ...result });
     }
 
+    let syncResult = null;
+    if (options.syncTelemetry) {
+      try {
+        const result = await runSync(rootDir, { limit: options.syncLimit || 20 });
+        syncResult = {
+          synced: Boolean(result.synced),
+          sessions: Number(result.aggregate?.sessions || 0),
+          estimatedWastedTokens: Number(result.aggregate?.estimatedWastedTokens || 0),
+          wastePercent: Number(result.aggregate?.wastePercent || 0),
+        };
+      } catch (error) {
+        syncResult = {
+          synced: false,
+          error: error && error.message ? error.message : String(error),
+        };
+      }
+    }
+
     return {
       schemaVersion: 1,
       command: "agent",
@@ -352,6 +370,7 @@ module.exports = function createAgent(deps) {
       actionsFailed: results.filter((item) => item.status === "failed").length,
       actionsObserved: results.filter((item) => item.status === "observed" || item.status === "pending_approval").length,
       autoDetect: autoDetectResult,
+      sync: syncResult,
       results,
       privacy: {
         rawPrompts: false,
@@ -400,6 +419,16 @@ module.exports = function createAgent(deps) {
         lines.push(`  - ${f.message}`);
       });
     }
+    if (result.sync) {
+      lines.push("");
+      lines.push("Sync");
+      if (result.sync.synced) {
+        lines.push(`  Sessions: ${result.sync.sessions}`);
+        lines.push(`  Likely wasted: ${result.sync.estimatedWastedTokens.toLocaleString()} (${result.sync.wastePercent}%)`);
+      } else {
+        lines.push(`  Status: not synced${result.sync.error ? ` (${result.sync.error})` : ""}`);
+      }
+    }
     if (result.results.length) {
       lines.push("");
       lines.push("Actions");
@@ -418,9 +447,11 @@ module.exports = function createAgent(deps) {
     if (!options.watch) return runAgentOnce(rootDir, options);
 
     const intervalMs = Math.max(5, Number(options.interval || 15)) * 1000;
+    const syncIntervalMs = Math.max(30, Number(options.syncInterval || 60)) * 1000;
     let running = true;
     let sleepResolve = null;
     let firstRun = true;
+    let lastSyncAt = 0;
 
     if (options.open) {
       const config = loadConfig();
@@ -445,7 +476,14 @@ module.exports = function createAgent(deps) {
     process.on("SIGTERM", shutdown);
 
     while (running) {
-      const runOptions = { ...options, autoDetect: firstRun && options.autoDetect !== false };
+      const now = Date.now();
+      const shouldSync = options.noSync !== true && (lastSyncAt === 0 || now - lastSyncAt >= syncIntervalMs);
+      if (shouldSync) lastSyncAt = now;
+      const runOptions = {
+        ...options,
+        autoDetect: firstRun && options.autoDetect !== false,
+        syncTelemetry: shouldSync,
+      };
       firstRun = false;
       const result = await runAgentOnce(rootDir, runOptions);
       if (!running) break;

package/lib/prismo-dev/cli.js

@@ -3,7 +3,7 @@ const { printHelp, printCommandHelp } = require("./help");
 
 const VALID_COMMANDS = new Set([
   "dev", "init", "doctor", "firewall", "benchmark", "shield", "mcp",
-  "connect", "sync", "status", "disconnect", "agent", "setup", "scan",
+  "connect", "sync", "status", "disconnect", "agent", "connector", "setup", "scan",
   "optimize", "context", "cc", "cursor", "receipt", "instructions",
   "timeline", "replay", "boundaries", "usage", "guard", "watch", "demo",
 ]);
@@ -70,6 +70,12 @@ function createCli(deps) {
     runGuard,
     renderAgentTerminal,
     runAgent,
+    renderConnectorTerminal,
+    runConnectorInstall,
+    runConnectorStart,
+    runConnectorStatus,
+    runConnectorStop,
+    runConnectorUninstall,
     renderInstructionsAblationTerminal,
     renderInstructionsApplyTerminal,
     renderInstructionsAuditTerminal,
@@ -131,7 +137,7 @@ function createCli(deps) {
       return;
     }
     if (!VALID_COMMANDS.has(command)) {
-      throw new Error(`Unknown command: ${command}. Try: prismo connect, prismo agent, prismo guard, prismo sync, prismo doctor, prismo watch, prismo receipt, prismo benchmark, prismo shield, prismo mcp, prismo firewall, prismo init, prismo scan, prismo optimize, prismo context, prismo cc, prismo cursor, or prismo usage`);
+      throw new Error(`Unknown command: ${command}. Try: prismo connect, prismo connector, prismo agent, prismo guard, prismo sync, prismo doctor, prismo watch, prismo receipt, prismo benchmark, prismo shield, prismo mcp, prismo firewall, prismo init, prismo scan, prismo optimize, prismo context, prismo cc, prismo cursor, or prismo usage`);
     }
 
     if (command === "demo") {
@@ -314,6 +320,15 @@ function createCli(deps) {
       const userIndex = rest.indexOf("--user");
       const deviceIndex = rest.indexOf("--device");
       const limitIndex = rest.indexOf("--limit");
+      const intervalIndex = rest.indexOf("--interval");
+      const syncIntervalIndex = rest.indexOf("--sync-interval");
+      const modeIndex = rest.indexOf("--mode");
+      const modeValue = modeIndex >= 0 ? rest[modeIndex + 1] : "autopilot";
+      if (!AGENT_VALID_MODES.has(modeValue)) {
+        throw new Error(`Invalid connector mode: ${modeValue}. Valid modes: observe, suggest, autopilot`);
+      }
+      const positional = getPositionals(rest, new Set(["--token", "--api-url", "--org", "--user", "--device", "--limit", "--interval", "--sync-interval", "--mode"]));
+      const target = positional[0] || process.cwd();
       const result = runConnect({
         token: tokenIndex >= 0 ? rest[tokenIndex + 1] : null,
         apiUrl: apiUrlIndex >= 0 ? rest[apiUrlIndex + 1] : null,
@@ -322,6 +337,17 @@ function createCli(deps) {
         device: deviceIndex >= 0 ? rest[deviceIndex + 1] : null,
         limit: parsePositiveInt(limitIndex >= 0 ? rest[limitIndex + 1] : null, 20),
       });
+      if (result.connected && !rest.includes("--no-agent") && runConnectorInstall) {
+        result.connector = runConnectorInstall(target, {
+          interval: parsePositiveInt(intervalIndex >= 0 ? rest[intervalIndex + 1] : null, 15),
+          syncInterval: parsePositiveInt(syncIntervalIndex >= 0 ? rest[syncIntervalIndex + 1] : null, 60),
+          mode: modeValue,
+          dryRun: rest.includes("--dry-run"),
+        });
+        result.next = result.connector?.started
+          ? [`${NPX_COMMAND} status`, "Refresh Prismo Workspace"]
+          : [`${NPX_COMMAND} connector install`, `${NPX_COMMAND} status`];
+      }
       if (result.connected && (rest.includes("--open") || !rest.includes("--no-open"))) {
         openUrl("https://getprismo.dev/dashboard/dev");
       }
@@ -330,6 +356,40 @@ function createCli(deps) {
       return;
     }
 
+    if (command === "connector") {
+      const json = rest.includes("--json");
+      const intervalIndex = rest.indexOf("--interval");
+      const syncIntervalIndex = rest.indexOf("--sync-interval");
+      const modeIndex = rest.indexOf("--mode");
+      const modeValue = modeIndex >= 0 ? rest[modeIndex + 1] : "autopilot";
+      if (!AGENT_VALID_MODES.has(modeValue)) {
+        throw new Error(`Invalid connector mode: ${modeValue}. Valid modes: observe, suggest, autopilot`);
+      }
+      const positional = getPositionals(rest, new Set(["--interval", "--sync-interval", "--mode"]));
+      const action = ["install", "start", "stop", "status", "uninstall"].includes(positional[0]) ? positional[0] : "status";
+      const target = ["install"].includes(action) ? positional[1] || process.cwd() : positional[0] || process.cwd();
+      let result;
+      if (action === "install") {
+        result = runConnectorInstall(target, {
+          interval: parsePositiveInt(intervalIndex >= 0 ? rest[intervalIndex + 1] : null, 15),
+          syncInterval: parsePositiveInt(syncIntervalIndex >= 0 ? rest[syncIntervalIndex + 1] : null, 60),
+          mode: modeValue,
+          dryRun: rest.includes("--dry-run"),
+        });
+      } else if (action === "start") {
+        result = runConnectorStart({ dryRun: rest.includes("--dry-run") });
+      } else if (action === "stop") {
+        result = runConnectorStop({ dryRun: rest.includes("--dry-run") });
+      } else if (action === "uninstall") {
+        result = runConnectorUninstall({ dryRun: rest.includes("--dry-run") });
+      } else {
+        result = runConnectorStatus();
+      }
+      if (json) console.log(JSON.stringify(result, null, 2));
+      else console.log(renderConnectorTerminal(result));
+      return;
+    }
+
     if (command === "sync") {
       const json = rest.includes("--json");
       const limitIndex = rest.indexOf("--limit");
@@ -363,6 +423,7 @@ function createCli(deps) {
     if (command === "agent") {
       const json = rest.includes("--json");
       const intervalIndex = rest.indexOf("--interval");
+      const syncIntervalIndex = rest.indexOf("--sync-interval");
       const limitIndex = rest.indexOf("--limit");
       const budgetIndex = rest.indexOf("--budget");
       const modeIndex = rest.indexOf("--mode");
@@ -370,7 +431,7 @@ function createCli(deps) {
       if (!AGENT_VALID_MODES.has(modeValue)) {
         throw new Error(`Invalid agent mode: ${modeValue}. Valid modes: observe, suggest, autopilot`);
       }
-      const positional = getPositionals(rest, new Set(["--interval", "--limit", "--budget", "--mode"]));
+      const positional = getPositionals(rest, new Set(["--interval", "--sync-interval", "--limit", "--budget", "--mode"]));
       const target = positional[0] || process.cwd();
       const agentOptions = {
         json,
@@ -378,8 +439,11 @@ function createCli(deps) {
         watch: rest.includes("--watch") && !rest.includes("--once"),
         open: rest.includes("--open"),
         autoDetect: !rest.includes("--no-detect"),
+        noSync: rest.includes("--no-sync"),
         interval: parsePositiveInt(intervalIndex >= 0 ? rest[intervalIndex + 1] : null, 15),
+        syncInterval: parsePositiveInt(syncIntervalIndex >= 0 ? rest[syncIntervalIndex + 1] : null, 60),
         limit: parsePositiveInt(limitIndex >= 0 ? rest[limitIndex + 1] : null, 5),
+        syncLimit: parsePositiveInt(limitIndex >= 0 ? rest[limitIndex + 1] : null, 20),
         tokenBudget: parseTokenBudget(budgetIndex >= 0 ? rest[budgetIndex + 1] : null) || 600000,
       };
       const result = await runAgent(target, agentOptions);

package/lib/prismo-dev/cloud-sync.js

@@ -411,6 +411,11 @@ module.exports = function createCloudSync(deps) {
     lines.push(`Config: ${result.configPath}`);
     lines.push(`API: ${result.apiUrl}`);
     lines.push(`Device: ${result.device.name}`);
+    if (result.connector) {
+      lines.push(`Connector: ${result.connector.started ? "started" : result.connector.installed ? "installed" : "not started"}`);
+      if (result.connector.reason) lines.push(`Connector note: ${result.connector.reason}`);
+      if (result.connector.error) lines.push(`Connector error: ${result.connector.error}`);
+    }
     lines.push("");
     lines.push("Next");
     result.next.forEach((item, index) => lines.push(`${index + 1}. ${item}`));

package/lib/prismo-dev/connector.js

@@ -0,0 +1,306 @@
+module.exports = function createConnector(deps) {
+  const {
+    fs,
+    os,
+    path,
+    spawnSync,
+    NPX_COMMAND,
+  } = deps;
+
+  const LABEL = "dev.getprismo.connector";
+  const BACKGROUND_COMMAND = String(NPX_COMMAND || "").includes(" -y ")
+    ? NPX_COMMAND
+    : "npx -y getprismo@latest";
+
+  function prismoHome() {
+    return process.env.PRISMO_HOME || path.join(os.homedir(), ".prismo");
+  }
+
+  function connectorDir() {
+    return path.join(prismoHome(), "connector");
+  }
+
+  function statePath() {
+    return path.join(connectorDir(), "state.json");
+  }
+
+  function scriptPath() {
+    return path.join(connectorDir(), "run.sh");
+  }
+
+  function logPath() {
+    return path.join(connectorDir(), "connector.log");
+  }
+
+  function errorLogPath() {
+    return path.join(connectorDir(), "connector.err.log");
+  }
+
+  function plistPath() {
+    return path.join(os.homedir(), "Library", "LaunchAgents", `${LABEL}.plist`);
+  }
+
+  function readJson(filePath) {
+    try {
+      if (!fs.existsSync(filePath)) return null;
+      return JSON.parse(fs.readFileSync(filePath, "utf8"));
+    } catch {
+      return null;
+    }
+  }
+
+  function writeJson(filePath, payload) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+  }
+
+  function shellEscape(value) {
+    return `'${String(value).replace(/'/g, "'\\''")}'`;
+  }
+
+  function xmlEscape(value) {
+    return String(value)
+      .replace(/&/g, "&")
+      .replace(/</g, "&lt;")
+      .replace(/>/g, "&gt;")
+      .replace(/"/g, "&quot;");
+  }
+
+  function launchctl(args, options = {}) {
+    if (options.dryRun) return { status: 0, stdout: "", stderr: "" };
+    const result = spawnSync("launchctl", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+    return {
+      status: result.status,
+      stdout: String(result.stdout || ""),
+      stderr: String(result.stderr || ""),
+    };
+  }
+
+  function writeRunner(rootDir, options = {}) {
+    const root = path.resolve(rootDir || process.cwd());
+    const interval = Math.max(5, Number(options.interval || 15));
+    const syncInterval = Math.max(30, Number(options.syncInterval || 60));
+    const mode = options.mode || "autopilot";
+    fs.mkdirSync(connectorDir(), { recursive: true });
+    const command = `${BACKGROUND_COMMAND} agent --watch --interval ${interval} --sync-interval ${syncInterval} --mode ${shellEscape(mode)} ${shellEscape(root)}`;
+    const contents = [
+      "#!/bin/sh",
+      "set -eu",
+      `cd ${shellEscape(root)}`,
+      `exec ${command}`,
+      "",
+    ].join("\n");
+    fs.writeFileSync(scriptPath(), contents, { encoding: "utf8", mode: 0o700 });
+    writeJson(statePath(), {
+      schemaVersion: 1,
+      installedAt: new Date().toISOString(),
+      root,
+      interval,
+      syncInterval,
+      mode,
+      command,
+      platform: process.platform,
+      runner: scriptPath(),
+      logPath: logPath(),
+      errorLogPath: errorLogPath(),
+    });
+    return { root, interval, syncInterval, mode, command };
+  }
+
+  function writePlist() {
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/sh</string>
+    <string>${xmlEscape(scriptPath())}</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${xmlEscape(logPath())}</string>
+  <key>StandardErrorPath</key>
+  <string>${xmlEscape(errorLogPath())}</string>
+</dict>
+</plist>
+`;
+    fs.mkdirSync(path.dirname(plistPath()), { recursive: true });
+    fs.writeFileSync(plistPath(), plist, "utf8");
+  }
+
+  function isMacLaunchdAvailable() {
+    return process.platform === "darwin";
+  }
+
+  function runConnectorInstall(rootDir = process.cwd(), options = {}) {
+    const runner = writeRunner(rootDir, options);
+    if (!isMacLaunchdAvailable()) {
+      return {
+        schemaVersion: 1,
+        command: "connector",
+        action: "install",
+        installed: false,
+        started: false,
+        platform: process.platform,
+        statePath: statePath(),
+        runner: scriptPath(),
+        reason: "background-service-not-supported",
+        next: [`${NPX_COMMAND} agent --watch`],
+      };
+    }
+
+    writePlist();
+    launchctl(["bootout", `gui/${process.getuid()}`, plistPath()], options);
+    const bootstrap = launchctl(["bootstrap", `gui/${process.getuid()}`, plistPath()], options);
+    const kickstart = launchctl(["kickstart", "-k", `gui/${process.getuid()}/${LABEL}`], options);
+    const started = bootstrap.status === 0 || kickstart.status === 0 || options.dryRun;
+    return {
+      schemaVersion: 1,
+      command: "connector",
+      action: "install",
+      installed: true,
+      started,
+      label: LABEL,
+      root: runner.root,
+      mode: runner.mode,
+      interval: runner.interval,
+      syncInterval: runner.syncInterval,
+      plistPath: plistPath(),
+      statePath: statePath(),
+      runner: scriptPath(),
+      logPath: logPath(),
+      errorLogPath: errorLogPath(),
+      error: started ? null : (bootstrap.stderr || kickstart.stderr || "launchctl failed").trim(),
+    };
+  }
+
+  function runConnectorStart(options = {}) {
+    if (!isMacLaunchdAvailable()) {
+      return { schemaVersion: 1, command: "connector", action: "start", started: false, reason: "background-service-not-supported" };
+    }
+    if (!fs.existsSync(plistPath())) {
+      return { schemaVersion: 1, command: "connector", action: "start", started: false, reason: "not-installed", next: [`${NPX_COMMAND} connector install`] };
+    }
+    const result = launchctl(["kickstart", "-k", `gui/${process.getuid()}/${LABEL}`], options);
+    return {
+      schemaVersion: 1,
+      command: "connector",
+      action: "start",
+      started: result.status === 0 || options.dryRun,
+      label: LABEL,
+      error: result.status === 0 || options.dryRun ? null : result.stderr.trim(),
+    };
+  }
+
+  function runConnectorStop(options = {}) {
+    if (!isMacLaunchdAvailable()) {
+      return { schemaVersion: 1, command: "connector", action: "stop", stopped: false, reason: "background-service-not-supported" };
+    }
+    const result = launchctl(["bootout", `gui/${process.getuid()}`, plistPath()], options);
+    return {
+      schemaVersion: 1,
+      command: "connector",
+      action: "stop",
+      stopped: result.status === 0 || options.dryRun,
+      label: LABEL,
+      error: result.status === 0 || options.dryRun ? null : result.stderr.trim(),
+    };
+  }
+
+  function runConnectorUninstall(options = {}) {
+    const stop = runConnectorStop(options);
+    if (!options.dryRun) {
+      if (fs.existsSync(plistPath())) fs.rmSync(plistPath(), { force: true });
+      if (fs.existsSync(scriptPath())) fs.rmSync(scriptPath(), { force: true });
+    }
+    return {
+      schemaVersion: 1,
+      command: "connector",
+      action: "uninstall",
+      uninstalled: true,
+      stopped: stop.stopped,
+      removed: [plistPath(), scriptPath()],
+    };
+  }
+
+  function runConnectorStatus() {
+    const state = readJson(statePath());
+    const installed = fs.existsSync(plistPath()) || fs.existsSync(scriptPath());
+    let online = false;
+    let raw = "";
+    if (isMacLaunchdAvailable() && fs.existsSync(plistPath())) {
+      const result = launchctl(["print", `gui/${process.getuid()}/${LABEL}`]);
+      raw = `${result.stdout}${result.stderr}`;
+      online = result.status === 0 && /state = running|pid = \d+/i.test(raw);
+    }
+    return {
+      schemaVersion: 1,
+      command: "connector",
+      action: "status",
+      installed,
+      online,
+      label: LABEL,
+      platform: process.platform,
+      state,
+      plistPath: plistPath(),
+      runner: scriptPath(),
+      logPath: logPath(),
+      errorLogPath: errorLogPath(),
+    };
+  }
+
+  function renderConnectorTerminal(result) {
+    const lines = [];
+    lines.push("");
+    lines.push("PrismoDev Connector");
+    lines.push("");
+    if (result.action === "status") {
+      lines.push(`Installed: ${result.installed ? "yes" : "no"}`);
+      lines.push(`Status: ${result.online ? "online" : "idle"}`);
+      if (result.state?.root) lines.push(`Repo: ${result.state.root}`);
+      if (result.state?.interval) lines.push(`Poll: every ${result.state.interval}s`);
+      if (result.state?.syncInterval) lines.push(`Sync: every ${result.state.syncInterval}s`);
+      lines.push(`Logs: ${result.logPath}`);
+    } else if (result.action === "install") {
+      lines.push(`Status: ${result.started ? "started" : result.installed ? "installed" : "not installed"}`);
+      if (result.root) lines.push(`Repo: ${result.root}`);
+      if (result.interval) lines.push(`Poll: every ${result.interval}s`);
+      if (result.syncInterval) lines.push(`Sync: every ${result.syncInterval}s`);
+      if (result.reason) lines.push(`Note: ${result.reason}`);
+      if (result.error) lines.push(`Error: ${result.error}`);
+    } else if (result.action === "start") {
+      lines.push(`Status: ${result.started ? "started" : "not started"}`);
+      if (result.reason) lines.push(`Note: ${result.reason}`);
+      if (result.error) lines.push(`Error: ${result.error}`);
+    } else if (result.action === "stop") {
+      lines.push(`Status: ${result.stopped ? "stopped" : "not stopped"}`);
+      if (result.reason) lines.push(`Note: ${result.reason}`);
+      if (result.error) lines.push(`Error: ${result.error}`);
+    } else if (result.action === "uninstall") {
+      lines.push("Status: uninstalled");
+    }
+    if (result.next?.length) {
+      lines.push("");
+      lines.push("Next");
+      result.next.forEach((item, index) => lines.push(`${index + 1}. ${item}`));
+    }
+    return lines.join("\n");
+  }
+
+  return {
+    LABEL,
+    renderConnectorTerminal,
+    runConnectorInstall,
+    runConnectorStart,
+    runConnectorStatus,
+    runConnectorStop,
+    runConnectorUninstall,
+    writeRunner,
+  };
+};

package/lib/prismo-dev/help.js

@@ -13,10 +13,11 @@ Usage:
   prismo mcp [path]
   prismo mcp doctor [--json] [path]
   prismo connect [--json] [--token TOKEN] [--api-url URL] [--org ORG] [--user USER] [--device NAME]
+  prismo connector [status|install|start|stop|uninstall] [--json] [--interval N] [--sync-interval N] [--mode observe|suggest|autopilot] [path]
   prismo sync [--json] [--dry-run] [--watch] [--interval N] [--limit N] [--tool all|codex|claude|cursor] [path]
   prismo status [--json]
   prismo disconnect [--json]
-  prismo agent [--json] [--once] [--watch] [--interval N] [--limit N] [--mode MODE] [path]
+  prismo agent [--json] [--once] [--watch] [--interval N] [--sync-interval N] [--limit N] [--mode MODE] [path]
   prismo setup [--json] [--proxy-url URL] [path]
   prismo scan [--fix] [--ci] [--json] [--usage] [--optimizer-fit] [--report-card] [--simple] [--no-report] [path]
   prismo optimize [scope] [--json] [path]
@@ -44,6 +45,7 @@ Commands:
   shield      Run a noisy command, store full output locally, and return a compact summary.
   mcp         Start a local MCP server exposing Prismo tools over stdio.
   connect     Store a PrismoDev cloud connection for seamless dashboard sync.
+  connector   Install or manage the background Prismo Workspace connector.
   sync        Send safe aggregate local agent telemetry to Prismo; use --watch for background-style sync.
   status      Show local PrismoDev connection and last sync state.
   disconnect  Remove the local PrismoDev cloud connection.
@@ -77,6 +79,7 @@ Options:
   --firewall Generate cc timeline-derived firewall suggestion files.
   --task TASK Name the task for timeline-derived firewall suggestions.
   --interval N Refresh interval in seconds for watch mode.
+  --sync-interval N Telemetry sync interval in seconds for the background connector.
   --dry-run  Preview doctor/fix actions without writing files.
   --apply-ignores-only Only create/suggest AI ignore files in doctor mode.
   --apply-suggestions Append missing recommended ignore rules with backups.
@@ -98,6 +101,7 @@ Options:
   --org ORG Organization identifier for connect mode.
   --user USER User email or identifier for connect mode.
   --device NAME Local device name for connect mode.
+  --no-agent  Connect without installing the background workspace connector.
   --tool TOOL Tool filter for sync mode: all, codex, claude, or cursor.
   --watch     Keep sync running and send updates on an interval.
   --once      Run watch mode once, useful for tests and scripts.
@@ -406,6 +410,7 @@ Output:
 
 Usage:
   prismo connect [--json] [--token TOKEN] [--api-url URL] [--org ORG] [--user USER] [--device NAME]
+  prismo connector [status|install|start|stop|uninstall] [--json] [--interval N] [--sync-interval N] [--mode observe|suggest|autopilot] [path]
   prismo sync [--json] [--dry-run] [--watch] [--interval N] [--limit N] [--tool all|codex|claude|cursor] [path]
   prismo status [--json]
   prismo disconnect [--json]
@@ -413,6 +418,10 @@ Usage:
 Examples:
   prismo connect --token <token>
   prismo connect --token <token> --api-url https://api.getprismo.dev
+  prismo connect --token <token> --no-agent
+  prismo connector status
+  prismo connector install
+  prismo connector install --sync-interval 120
   prismo sync --dry-run
   prismo sync
   prismo sync --watch --interval 60
@@ -420,10 +429,38 @@ Examples:
   prismo disconnect
 
 Output:
-  connect stores a local PrismoDev device connection in ~/.prismo/config.json.
+  connect stores a local PrismoDev device connection in ~/.prismo/config.json and starts the background workspace connector by default.
+  connector keeps Prismo Workspace online so repairs queued in the dashboard run locally without copy/paste commands, and continuously syncs aggregate telemetry on a controlled interval.
   sync reads local Codex, Claude Code, and Cursor session logs, builds aggregate agent-efficiency telemetry, and sends it to Prismo.
   sync --watch keeps running so a local service manager can keep the Waste Scanner dashboard fresh.
   Sync does not upload prompts, source code, file contents, stdout, stderr, or full command logs.`,
+  connector: `PrismoDev Connector
+
+Usage:
+  prismo connector status [--json]
+  prismo connector install [--json] [--interval N] [--sync-interval N] [--mode observe|suggest|autopilot] [path]
+  prismo connector start [--json]
+  prismo connector stop [--json]
+  prismo connector uninstall [--json]
+
+Modes:
+  observe    Keep the workspace connected but do not execute queued repairs.
+  suggest    Stage repairs as pending approval.
+  autopilot  Execute safe queued repairs automatically. (default)
+
+Examples:
+  prismo connector status
+  prismo connector install
+  prismo connector install --mode suggest --interval 30
+  prismo connector install --sync-interval 120
+  prismo connector stop
+  prismo connector uninstall
+
+Output:
+  Installs and manages the local Prismo Workspace connector.
+  On macOS this creates a LaunchAgent so Prismo stays online after the terminal closes.
+  The connector claims safe repairs queued from Prismo Cloud, runs them locally, continuously syncs aggregate telemetry, and reports status back.
+  It does not upload prompts, source code, file contents, stdout, stderr, or full command logs.`,
   sync: `PrismoDev Sync
 
 Usage:
@@ -455,7 +492,7 @@ Output:
   agent: `PrismoDev Agent
 
 Usage:
-  prismo agent [--json] [--once] [--watch] [--open] [--no-detect] [--interval N] [--limit N] [--mode MODE] [path]
+  prismo agent [--json] [--once] [--watch] [--open] [--no-detect] [--no-sync] [--interval N] [--sync-interval N] [--limit N] [--mode MODE] [path]
 
 Modes:
   observe    Watch and report actions without executing. No changes made.
@@ -465,6 +502,7 @@ Modes:
 Examples:
   prismo agent --once
   prismo agent --watch --interval 15
+  prismo agent --watch --sync-interval 120
   prismo agent --watch --mode observe
   prismo agent --watch --mode suggest
   prismo agent --watch --open
@@ -473,12 +511,13 @@ Examples:
 Options:
   --open        Open the Prismo workspace in the browser on start.
   --no-detect   Skip the initial auto-detect scan on first poll.
+  --no-sync     Keep watch mode from continuously syncing aggregate telemetry.
 
 Output:
   On first poll, the agent proactively runs doctor to detect context issues.
   In autopilot mode it auto-fixes safe issues. In suggest mode it reports them as pending_approval in the workspace.
   Claims safe workspace actions queued from Prismo Cloud, runs them locally, and reports status back.
-  Sends heartbeat to Prismo Cloud on each poll so the dashboard shows agent online/offline status.
+  Sends heartbeat to Prismo Cloud on each poll and syncs aggregate telemetry on a controlled interval so the dashboard stays fresh.
   Handles SIGINT/SIGTERM gracefully and marks the agent offline before exiting.
   Supported actions are doctor, sync, guard, context/optimize, and shield with a conservative command allowlist.
   Agent does not upload prompts, source code, file contents, stdout, stderr, or full command logs.`,

package/lib/prismo-dev-scan.js

@@ -3,7 +3,7 @@ const http = require("http");
 const https = require("https");
 const os = require("os");
 const path = require("path");
-const { execSync } = require("child_process");
+const { execSync, spawnSync } = require("child_process");
 const { version: PACKAGE_VERSION } = require("../package.json");
 
 function openUrl(url) {
@@ -333,6 +333,21 @@ const {
   openUrl,
 });
 
+const {
+  renderConnectorTerminal,
+  runConnectorInstall,
+  runConnectorStart,
+  runConnectorStatus,
+  runConnectorStop,
+  runConnectorUninstall,
+} = require("./prismo-dev/connector")({
+  fs,
+  os,
+  path,
+  spawnSync,
+  NPX_COMMAND,
+});
+
 const {
   buildInstructionsAblationPlan,
   buildInstructionsApply,
@@ -439,6 +454,12 @@ const { runCli } = require("./prismo-dev/cli")({
   runGuard,
   renderAgentTerminal,
   runAgent,
+  renderConnectorTerminal,
+  runConnectorInstall,
+  runConnectorStart,
+  runConnectorStatus,
+  runConnectorStop,
+  runConnectorUninstall,
   renderInstructionsAblationTerminal,
   renderInstructionsApplyTerminal,
   renderInstructionsAuditTerminal,
@@ -531,6 +552,11 @@ module.exports = {
   runConnect,
   runDisconnect,
   runGuard,
+  runConnectorInstall,
+  runConnectorStart,
+  runConnectorStatus,
+  runConnectorStop,
+  runConnectorUninstall,
   runStatus,
   runSync,
   getUsageSummary,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getprismo",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "Local AI coding workflow scanner for Codex, Claude Code, Cursor, and token-waste diagnostics.",
   "license": "MIT",
   "homepage": "https://github.com/shanirsh/prismodev#readme",