rnxsim 0.1.352 → 0.1.354

package/dist-lib/jump-to-source-babel.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/menu.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/menu.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/public-brand.ts
 var name = "rnx";

package/dist-lib/metro-production-bundle.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/metro-production-bundle.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/metro-production-bundle.ts
 var RNXSIM_METRO_PRODUCTION_BUNDLE_OPTION = "rnxsim";

package/dist-lib/metro.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -514,7 +514,7 @@ function readActiveRuntime() {
 var DAEMON_LOCKFILE_MAX_BYTES = 16 * 1024;
 
 // src/runtime-assets.ts
-var SOOTSIM_RUNTIME_MISSING_MESSAGE = "[rnx] no engine runtime installed \u2014 run `rnx setup`, or `rnx runtime install`";
+var SOOTSIM_RUNTIME_MISSING_MESSAGE = "[rnx] no engine runtime installed. run `rnx runtime install`";
 var _monorepoRootCache;
 function findMonorepoRoot() {
   if (_monorepoRootCache !== void 0) return _monorepoRootCache;

package/dist-lib/profiles.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/public-brand.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/react-native-host-modules.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/react-native-host-modules.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/react-native-host-modules.ts
 var REACT_NATIVE_PASSTHROUGH_SPECIFIERS = [

package/dist-lib/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/scripts/dev-server-scanner.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/sdk.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -10668,6 +10668,7 @@ __export(home_paths_exports, {
   isDaemonLockfileFresh: () => isDaemonLockfileFresh,
   isDevBridgeLockfileFresh: () => isDevBridgeLockfileFresh,
   isDevWorkstation: () => isDevWorkstation,
+  isOnboardingComplete: () => isOnboardingComplete,
   isSootsimDevCheckout: () => isSootsimDevCheckout,
   profilesDir: () => profilesDir,
   readActiveRuntime: () => readActiveRuntime,
@@ -10677,6 +10678,7 @@ __export(home_paths_exports, {
   readOrCreateAnonymousId: () => readOrCreateAnonymousId,
   readPrivacyPreferences: () => readPrivacyPreferences,
   readSharedConfig: () => readSharedConfig,
+  readSimulatorDriverPreference: () => readSimulatorDriverPreference,
   removeDaemonLockfile: () => removeDaemonLockfile,
   removeDevBridgeLockfile: () => removeDevBridgeLockfile,
   runtimeDir: () => runtimeDir,
@@ -10687,6 +10689,7 @@ __export(home_paths_exports, {
   writeActiveRuntime: () => writeActiveRuntime,
   writeDaemonLockfile: () => writeDaemonLockfile,
   writeDevBridgeLockfile: () => writeDevBridgeLockfile,
+  writeOnboardingPreferences: () => writeOnboardingPreferences,
   writePrivacyPreferences: () => writePrivacyPreferences,
   writeRuntimeUpgradeNotice: () => writeRuntimeUpgradeNotice,
   writeSharedConfig: () => writeSharedConfig
@@ -10793,6 +10796,19 @@ function writeSharedConfig(patch) {
   import_node_fs3.default.renameSync(tmp, configFilePath());
   return next;
 }
+function isOnboardingComplete() {
+  return readSharedConfig().onboardingVersion === CURRENT_ONBOARDING_VERSION;
+}
+function readSimulatorDriverPreference() {
+  const driver = readSharedConfig().simulatorDriver;
+  return driver === "electron" || driver === "playwright" ? driver : null;
+}
+function writeOnboardingPreferences(driver) {
+  writeSharedConfig({
+    onboardingVersion: CURRENT_ONBOARDING_VERSION,
+    simulatorDriver: driver
+  });
+}
 function readPrivacyPreferences() {
   const settings = readSharedConfig().settings;
   const productAnalytics = settings?.productAnalytics;
@@ -11138,7 +11154,7 @@ function removeDevBridgeLockfile(owner) {
   } catch {
   }
 }
-var import_node_crypto, import_node_fs3, import_node_os, import_node_path4, SOOTSIM_HOME_ENV, ACTIVE_RUNTIME_FILE, DAEMON_LOCKFILE, DEV_BRIDGES_DIR, CONFIG_FILE, DAEMON_HEARTBEAT_STALE_MS, DAEMON_LOCKFILE_MAX_BYTES, DAEMON_CLAIM_STALE_MS;
+var import_node_crypto, import_node_fs3, import_node_os, import_node_path4, SOOTSIM_HOME_ENV, ACTIVE_RUNTIME_FILE, DAEMON_LOCKFILE, DEV_BRIDGES_DIR, CONFIG_FILE, DAEMON_HEARTBEAT_STALE_MS, CURRENT_ONBOARDING_VERSION, DAEMON_LOCKFILE_MAX_BYTES, DAEMON_CLAIM_STALE_MS;
 var init_home_paths = __esm({
   "src/home-paths.ts"() {
     "use strict";
@@ -11152,6 +11168,7 @@ var init_home_paths = __esm({
     DEV_BRIDGES_DIR = "dev-bridges";
     CONFIG_FILE = "config.json";
     DAEMON_HEARTBEAT_STALE_MS = 3e4;
+    CURRENT_ONBOARDING_VERSION = 1;
     DAEMON_LOCKFILE_MAX_BYTES = 16 * 1024;
     DAEMON_CLAIM_STALE_MS = 3e4;
   }
@@ -18199,9 +18216,9 @@ function findElectronBin(startDir) {
 function findMacApp() {
   const root = getSootsimRoot();
   const candidates = [
-    "/Applications/sootsim.app",
-    (0, import_path5.resolve)(process.env.HOME || "", "Applications/sootsim.app"),
-    ...root ? [(0, import_path5.resolve)(root, "app/sootsim.app")] : []
+    "/Applications/rnx.app",
+    (0, import_path5.resolve)(process.env.HOME || "", "Applications/rnx.app"),
+    ...root ? [(0, import_path5.resolve)(root, "app/rnx.app")] : []
   ];
   const found = candidates.find((candidate) => (0, import_fs6.existsSync)(candidate));
   if (found) {
@@ -18230,20 +18247,17 @@ function findMacApp() {
 }
 function findFirstAppImage(dir) {
   if (!(0, import_fs6.existsSync)(dir)) return null;
-  const match = (0, import_fs6.readdirSync)(dir).filter((entry) => entry.startsWith("sootsim") && entry.endsWith(".AppImage")).sort().reverse()[0];
+  const match = (0, import_fs6.readdirSync)(dir).filter((entry) => entry.startsWith("rnx") && entry.endsWith(".AppImage")).sort().reverse()[0];
   return match ? (0, import_path5.join)(dir, match) : null;
 }
 function findLinuxInstall() {
   const root = getSootsimRoot();
   const directCandidates = [
-    (0, import_path5.resolve)(process.env.HOME || "", "Applications/sootsim.AppImage"),
-    (0, import_path5.resolve)(process.env.HOME || "", ".local/bin/sootsim.AppImage"),
-    "/opt/sootsim/sootsim.AppImage",
-    "/opt/sootsim/sootsim",
-    ...root ? [
-      (0, import_path5.resolve)(root, "app/sootsim.AppImage"),
-      (0, import_path5.resolve)(root, "release/linux-unpacked/sootsim")
-    ] : []
+    (0, import_path5.resolve)(process.env.HOME || "", "Applications/rnx.AppImage"),
+    (0, import_path5.resolve)(process.env.HOME || "", ".local/bin/rnx.AppImage"),
+    "/opt/rnx/rnx.AppImage",
+    "/opt/rnx/rnx",
+    ...root ? [(0, import_path5.resolve)(root, "app/rnx.AppImage"), (0, import_path5.resolve)(root, "release/linux-unpacked/rnx")] : []
   ];
   const directMatch = directCandidates.find((candidate) => (0, import_fs6.existsSync)(candidate));
   if (directMatch) {
@@ -18261,6 +18275,23 @@ function findLinuxInstall() {
     kind: "linux-appimage"
   };
 }
+function findWindowsInstall() {
+  for (const hive of ["HKCU", "HKLM"]) {
+    try {
+      const output = (0, import_child_process5.execFileSync)(
+        "reg",
+        ["query", `${hive}\\Software\\Classes\\rnx\\shell\\open\\command`, "/ve"],
+        { encoding: "utf8", timeout: 3e3 }
+      );
+      const executable = /"([^"\r\n]+\.exe)"/i.exec(output)?.[1];
+      if (executable && (0, import_fs6.existsSync)(executable)) {
+        return { path: executable, platform: "win32", kind: "win-exe" };
+      }
+    } catch {
+    }
+  }
+  return null;
+}
 function findDesktopCompanion() {
   const dev = findDevElectron();
   if (dev) return dev;
@@ -18282,6 +18313,7 @@ function findDesktopCompanion() {
   }
   if (process.platform === "darwin") return findMacApp();
   if (process.platform === "linux") return findLinuxInstall();
+  if (process.platform === "win32") return findWindowsInstall();
   return null;
 }
 async function spawnDetached(command, args, opts = {}) {
@@ -18328,7 +18360,7 @@ async function launchDesktopCompanion(url, install = findDesktopCompanion(), opt
 }
 function buildMacLaunchUrl(url, opts) {
   if (!opts.profileId && !opts.ephemeralProfile && !opts.ownerPid) return url;
-  const deepLink = new URL("sootsim://dev");
+  const deepLink = new URL("rnx://dev");
   deepLink.searchParams.set("url", url);
   if (opts.profileId) deepLink.searchParams.set("profile", opts.profileId);
   if (opts.ephemeralProfile) deepLink.searchParams.set("ephemeral", "1");
@@ -19219,6 +19251,32 @@ var init_open_url2 = __esm({
   }
 });
 
+// cli/commands/inspect/env.ts
+function isAgentEnv() {
+  if (process.env.SOOTSIM_AGENT === "0") return false;
+  for (const name2 of AGENT_ENV_VARS) {
+    const v = process.env[name2];
+    if (v && v.trim() && v !== "0") return true;
+  }
+  return false;
+}
+var AGENT_ENV_VARS;
+var init_env = __esm({
+  "cli/commands/inspect/env.ts"() {
+    "use strict";
+    AGENT_ENV_VARS = [
+      "SOOTSIM_AGENT",
+      "TM_SESSION",
+      "CLAUDECODE",
+      "CLAUDE_CODE_ENTRYPOINT",
+      "CLAUDE_CODE_SESSION_ID",
+      "CODEX_THREAD_ID",
+      "CURSOR_TRACE_ID",
+      "AIDER_MODEL"
+    ];
+  }
+});
+
 // cli/runtime-notes.ts
 function isChangelogEntry(value) {
   if (!value || typeof value !== "object") return false;
@@ -19665,7 +19723,7 @@ async function ensureBridgeForOpen(preferredPort, explicitPort = false) {
     assertExplicitBridgeLock(preferredPort, explicitPort, nextLock);
     if (nextLock && isDaemonLockfileFresh(nextLock) && await canConnectToBridge(nextLock.bridgePort, 250)) {
       console.error(
-        `  started local bridge on port ${nextLock.bridgePort}; run \`sootsim setup\` to install the background daemon`
+        `  Started a local bridge on port ${nextLock.bridgePort}. Run \`rnx daemon install\` to keep it ready between commands.`
       );
       return nextLock.bridgePort;
     }
@@ -20359,7 +20417,7 @@ function resolveTargetSim(sims, requestedId) {
   if (firstOpen) return firstOpen;
   throw new Error("no sim connected");
 }
-function printOpenedSim(openUrl2, sim, mode) {
+function printOpenedSim(openUrl2, sim, mode, quiet = false) {
   const [printableOpenUrl, printableSimUrl] = [openUrl2, sim.url].map((value) => {
     if (!value) return value;
     try {
@@ -20372,6 +20430,10 @@ function printOpenedSim(openUrl2, sim, mode) {
     }
     return value;
   });
+  if (quiet) {
+    console.log(`  Opened ConnectRN [${mode}]`);
+    return;
+  }
   console.log(
     `  ${mode === "current sim" ? "loaded" : "opened"}: ${printableOpenUrl} [${mode}]`
   );
@@ -20526,7 +20588,8 @@ async function runOpenCommand(args, opts = {}) {
       "--ephemeral",
       "--hot",
       "--no-hmr",
-      "--no-describe"
+      "--no-describe",
+      "--quiet"
     ],
     stripValueFlags: [
       "--base-url",
@@ -20539,6 +20602,7 @@ async function runOpenCommand(args, opts = {}) {
     ]
   });
   const requestedProfileId = args.find((_, i) => args[i - 1] === "--profile");
+  const quiet = args.includes("--quiet");
   const ephemeralProfile = args.includes("--ephemeral");
   const cdpPortArg = args.find((_, i) => args[i - 1] === "--cdp-port");
   const cdpPort = cdpPortArg ? Number(cdpPortArg) : void 0;
@@ -20623,7 +20687,7 @@ async function runOpenCommand(args, opts = {}) {
     console.error(`  unknown driver "${requestedDriverId}" \u2014 run \`rnx list --drivers\``);
     process.exit(1);
   }
-  const driverId = isDriverId(requestedDriverId) ? requestedDriverId : "playwright";
+  const driverId = isDriverId(requestedDriverId) ? requestedDriverId : process.env.CI === "1" || process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true" || isAgentEnv() || !process.stdin.isTTY ? "playwright" : readSimulatorDriverPreference() || "playwright";
   const driverHeadless = resolveDriverHeadless(args, driverId);
   if (cdpPort && driverId !== "playwright") {
     console.error("  rnx open: --cdp-port is only honored by the playwright driver");
@@ -20635,7 +20699,7 @@ async function runOpenCommand(args, opts = {}) {
     console.error("  rnx open: --hot and --no-hmr cannot be combined");
     process.exit(1);
   }
-  const hotMode = hotFlag ? true : noHmrFlag ? false : requestedDriverId !== "playwright";
+  const hotMode = hotFlag ? true : noHmrFlag ? false : driverId !== "playwright";
   const deviceArg = args.find((_, i) => args[i - 1] === "--device");
   if (deviceArg && !(deviceArg in import_settings.devices)) {
     console.error(`  rnx open: unknown device "${deviceArg}"`);
@@ -20761,7 +20825,7 @@ async function runOpenCommand(args, opts = {}) {
           applySootSimConfigToUrl(resolvedBaseUrl, runtimeConfig),
           buildShellUrlOpts
         );
-        printOpenedSim(shellUrl, { ...targetSim, url: shellUrl }, "current sim");
+        printOpenedSim(shellUrl, { ...targetSim, url: shellUrl }, "current sim", quiet);
         await maybeDescribeAfterOpen(parsed.wsPort, targetSim.id, args);
         return parsed.wsPort;
       }
@@ -20834,7 +20898,7 @@ async function runOpenCommand(args, opts = {}) {
   const match = outcome.sim;
   saveCurrentSimId(match.id);
   signalDriverLaunchConnected(result);
-  printOpenedSim(openUrl2, match, `${driver.name} driver`);
+  printOpenedSim(openUrl2, match, `${driver.name} driver`, quiet);
   await maybeDescribeAfterOpen(parsed.wsPort, match.id, args);
   return parsed.wsPort;
 }
@@ -21130,6 +21194,7 @@ var init_control = __esm({
     init_open_url2();
     init_ws_bridge();
     init_core();
+    init_env();
     DEFAULT_DRIVER_CONNECT_TIMEOUT_MS = 12e4;
     DRIVER_CONNECT_INTERVAL_MS = 100;
     DRIVER_CONNECT_HOST_GRACE_MS = 5e3;

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.354 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -446,7 +446,7 @@ function isValidRuntimeVersion(value) {
 }
 
 // src/runtime-assets.ts
-var SOOTSIM_RUNTIME_MISSING_MESSAGE = "[rnx] no engine runtime installed \u2014 run `rnx setup`, or `rnx runtime install`";
+var SOOTSIM_RUNTIME_MISSING_MESSAGE = "[rnx] no engine runtime installed. run `rnx runtime install`";
 var _monorepoRootCache;
 function findMonorepoRoot() {
   if (_monorepoRootCache !== void 0) return _monorepoRootCache;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rnxsim",
-  "version": "0.1.352",
+  "version": "0.1.354",
   "description": "rnx CLI, Vite and Metro plugins, and agent skills for driving React Native apps in the browser.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",

package/skills/contrast/SKILL.md

@@ -49,11 +49,11 @@ automation, inspecting the render tree, and managing sims.
 | `rnx claim` | take an exclusive lease on a sim |
 | `rnx agent` | attached projects + local agent sessions (codex/claude) |
 | `rnx close` | close a connected sim |
-| `rnx setup` | check local setup and install the recommended bridge daemon |
+| `rnx setup` | configure optional local conveniences |
 | `rnx compat` | check package compatibility |
 | `rnx report-issue` | send an explicitly approved compatibility report |
 | `rnx desktop` | launch or install the desktop companion |
-| `rnx daemon` | manage the optional background bridge service |
+| `rnx daemon` | manage the recommended background bridge service |
 | `rnx version` | show the CLI + engine runtime versions you are running |
 | `rnx upgrade` | update the rnx CLI and engine runtime to the latest |
 | `rnx serve` | run the rnx bridge in the foreground |
@@ -92,7 +92,7 @@ skills for working with the rnx native preview engine:
 | --- | --- |
 | `/rnx-debug` | Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under rnx. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the rnx CLI debug tooling first, not screenshots or ad-hoc logging. |
 | `/rnx-perf` | Optimize rnx engine and app performance — scroll jank, dropped frames, slow animation, idle CPU, memory growth, and "smooth normally but laggy under load" (video calls, busy machines). Covers measuring on the right thread with the right browser, proving each perf tier actually engages via its counters, a CPU-contention test harness, and the map of existing perf machinery so you improve it instead of reinventing it. For general app debugging load /rnx-debug first. |
-| `/rnx-setup` | Get rnx connected to your React Native app — from `rnx setup` to a driveable sim |
+| `/rnx-setup` | Get rnx connected to your React Native app with no project setup |
 | `/rnx-test` | Run automated tests against your React Native app under rnx with Maestro YAML or Detox/Jest |
 | `/rnx-visual` | Pixel-level rendering comparison between rnx and native iOS — fonts, gradients, shadows, image fidelity |
 

package/skills/rnx-setup/SKILL.md

@@ -1,13 +1,14 @@
 ---
 name: rnx-setup
-description: Get rnx connected to your React Native app — from `rnx setup` to a driveable sim
+description: Get rnx connected to your React Native app with no project setup
 ---
 
 # rnx setup
 
 you want to drive a React Native app with rnx from the CLI. this skill
-takes you from `rnx setup` to a connected, pinned sim that every other
-rnx skill assumes exists. no per-app rnx install is required. if
+takes you from a running development server to a connected, pinned sim that
+every other rnx skill assumes exists. rnx requires no project setup or per-app
+install. if
 `rnx describe` already
 returns a tree, you're past this skill — load `/rnx-debug` for
 debugging or `/rnx-test` for writing tests.
@@ -58,7 +59,8 @@ debugging or `/rnx-test` for writing tests.
 ## first move
 
 ```sh
-rnx setup                    # one-time guided setup; installs daemon
+rnx daemon status            # the persistent service makes agent commands much faster
+rnx daemon install           # enable it when missing on a supported personal machine
 rnx compat --json            # scan the app's native package compatibility
 rnx open 8081                # load a metro/expo dev server
 rnx list                     # confirm exactly one sim is reachable
@@ -66,6 +68,15 @@ rnx use <id>                 # pin it for the rest of the workflow
 rnx describe                 # smoke test — should print a render tree
 ```
 
+the background service keeps the local bridge and runtime ready between
+commands. without it, rnx still works by starting an on-demand bridge, but
+inspect, interaction, and test commands pay repeated startup cost. if the user
+declined it during onboarding, `rnx daemon install` is the direct way to enable
+it. CI does not need or install the service.
+
+bare `rnx` opens ConnectRN for a human to choose among local apps. agents and
+scripts should use `rnx open <port-or-url>` so the target is explicit.
+
 if you do not know the port, run `rnx open` with no target and pick from
 the detected dev servers. for hosted or unusual targets, pass the URL
 explicitly:
@@ -118,7 +129,8 @@ rnx runtime list             # is at least one engine runtime installed?
 rnx open <port>              # does loading explicitly work?
 ```
 
-if daemon is down: run `rnx setup`, or `rnx serve` in another shell for
+if the daemon is not installed: run `rnx daemon install`. if the registered
+daemon is down, run `rnx daemon restart`, or `rnx serve` in another shell for
 a foreground bridge. if no runtime is installed, `rnx open` installs it
 before launching. if open errors with "port unreachable": confirm your dev
 server is actually serving — the bundler has to be up before rnx can

package/src/agent-daemon-client.ts

@@ -361,7 +361,7 @@ export async function ensureDaemonRunning(
   }
   if (shouldSkipPersistentDaemon()) {
     throw new AgentDaemonError(
-      `no rnx bridge on port ${port}. run \`rnx setup\` to install the background daemon, or \`rnx serve\` in another shell.`,
+      `no rnx bridge on port ${port}. run \`rnx daemon install\` to enable the faster background service, or \`rnx serve\` in another shell.`,
       'DEV_HOST_REFUSED',
     )
   }

package/src/home-paths.ts

@@ -187,6 +187,8 @@ export function configFilePath(): string {
 
 export interface SharedConfig {
   telemetry?: boolean
+  onboardingVersion?: number
+  simulatorDriver?: 'electron' | 'playwright'
   settings?: Record<string, unknown>
   [key: string]: unknown
 }
@@ -222,6 +224,26 @@ export function writeSharedConfig(patch: Partial<SharedConfig>): SharedConfig {
   return next
 }
 
+const CURRENT_ONBOARDING_VERSION = 1
+
+export type SimulatorDriverPreference = 'electron' | 'playwright'
+
+export function isOnboardingComplete(): boolean {
+  return readSharedConfig().onboardingVersion === CURRENT_ONBOARDING_VERSION
+}
+
+export function readSimulatorDriverPreference(): SimulatorDriverPreference | null {
+  const driver = readSharedConfig().simulatorDriver
+  return driver === 'electron' || driver === 'playwright' ? driver : null
+}
+
+export function writeOnboardingPreferences(driver: SimulatorDriverPreference): void {
+  writeSharedConfig({
+    onboardingVersion: CURRENT_ONBOARDING_VERSION,
+    simulatorDriver: driver,
+  })
+}
+
 export interface PrivacyPreferences {
   productAnalytics: boolean
   crashReports: boolean

package/src/metro-plugin.ts

@@ -1,6 +1,6 @@
 // rnx metro plugin for opt-in dev shell and production bundle integration.
 // shell assets come from an engine runtime under ~/.sootsim/runtimes/, fetched
-// by `sootsim runtime install` / `sootsim setup`. ordinary localhost requests
+// by `rnx runtime install`. ordinary localhost requests
 // follow active; a version-owned localhost origin stays on its exact directory
 // when active changes, so one loaded shell cannot mix runtime chunk trees.
 //

package/src/runtime-assets.ts

@@ -9,7 +9,7 @@ import { isValidRuntimeVersion } from '@contrast/runtime-delivery'
 import { readActiveRuntime, runtimeDir } from './home-paths.ts'
 
 export const SOOTSIM_RUNTIME_MISSING_MESSAGE =
-  '[rnx] no engine runtime installed — run `rnx setup`, or `rnx runtime install`'
+  '[rnx] no engine runtime installed. run `rnx runtime install`'
 
 // --- dev-checkout mode boundary --------------------------------------------
 //

package/dist-cli/chunks/chunk-2JZXOHH6.js

@@ -1,4 +0,0 @@
-/*! rnx v0.1.352 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
-import { createRequire as __sootsimCreateRequire } from 'node:module'
-var require = __sootsimCreateRequire(import.meta.url)
-function p(){console.error("  no rnx desktop companion found."),console.error(""),console.error("  install the desktop app:"),console.error("    rnx desktop install"),console.error(""),console.error("  or run setup to install the background daemon:"),console.error("    rnx setup"),console.error("")}function t(r){console.error(""),console.error(`  no sim is connected to the rnx bridge on port ${r}.`),console.error(""),console.error("  start your app dev server, then open it in rnx:"),console.error("    npx expo start --localhost --port 8081"),console.error("    rnx open 8081"),console.error(""),console.error("  then inspect the live app:"),console.error("    rnx describe")}async function a(r,n,s){let e=[];try{e=await r.listSims()}catch{}if(console.error(""),e.length===0){t(n);return}console.error(`  no sim with id "${s}" is connected to the bridge on port ${n}.`),console.error(""),console.error("  connected sims:");for(let o of e){let i=[o.isPrimary?"primary":null,o.readyState,o.userVisible===!1?"hidden":o.userVisible===!0?"visible":null,o.userFocused?"focused":null].filter(Boolean).join(", ");console.error(`    ${o.id}  (${i})`)}console.error(""),console.error("  pass a valid --sim id, or run `rnx list` to see all sessions.")}export{p as a,t as b,a as c};