rnxsim 0.1.375 → 0.1.377

package/cli/commands/control.ts

@@ -13,9 +13,10 @@ import { isAppDeepLinkTarget, openAppUrl } from '../../src/app-url'
 import { isLoopbackHost } from '../../src/backend-origin'
 import { resolveSootsimShellBaseUrlForBridgePort } from '../../src/bridge-constants'
 import {
-  applySootSimConfigToUrl,
-  mergeSootSimConfig,
-  type SootSimConfig,
+  applyRNXConfigToUrl,
+  mergeRNXConfig,
+  RNX_CONFIG_QUERY_PARAM,
+  type RNXConfig,
 } from '../../src/config'
 import {
   resolveConnectionInput,
@@ -36,8 +37,8 @@ import {
   resolveDevCheckoutRuntimeRoot,
   runtimeVersionHostname,
 } from '../../src/runtime-assets'
-import { sootsimRuntime } from '../../src/runtime-delivery'
-import { loadSootSimAppConfig } from '../app-config'
+import { rnxRuntime } from '../../src/runtime-delivery'
+import { loadRNXAppConfig } from '../app-config'
 import {
   type DiscoveredAppFontSpec,
   discoverNativeLinkedAppFonts,
@@ -74,7 +75,7 @@ import type { DriverId, DriverLaunchResult } from '../drivers/types'
 interface ControlCommandOptions {
   port?: number
   timeoutMs?: number
-  runtimeConfig?: SootSimConfig
+  runtimeConfig?: RNXConfig
 }
 
 interface DriverConnectWaitOptions {
@@ -236,7 +237,7 @@ function assertExplicitBridgeLock(
     return
   }
   throw new Error(
-    `${rnxPublicBrand.commandName} open: requested bridge port ${preferredPort}, but the active daemon owns port ${lock.bridgePort}. explicit --port never selects another bridge; stop that daemon or use an isolated SOOTSIM_HOME.`,
+    `${rnxPublicBrand.commandName} open: requested bridge port ${preferredPort}, but the active daemon owns port ${lock.bridgePort}. explicit --port never selects another bridge; stop that daemon or use an isolated RNX_HOME.`,
   )
 }
 
@@ -341,7 +342,7 @@ function buildShellPathOpenUrl(target: string, baseUrl: string): string {
 // SootSim share/preview/build links (e.g. https://sootsim.com/preview/<id>,
 // https://contrast.dev/build/<owner>/<repo>/<branch>) are full player pages
 // served by the Contrast app — NOT Metro bundles and NOT driveable shell sims.
-// passing one to `sootsim open` used to fall through to the bundle resolver,
+// passing one to `rnx open` used to fall through to the bundle resolver,
 // which fetched the HTML page and choked with "Unexpected token '<'". two
 // hard reasons they can't become a CLI-driveable sim:
 //   1. the engine only attaches to the local CLI bridge from a localhost /
@@ -474,8 +475,8 @@ function normalizeReplacementPath(filePath: string): string {
   return path.resolve(process.cwd(), filePath)
 }
 
-function parseOpenRuntimeConfig(args: string[]): SootSimConfig | undefined {
-  const modules: NonNullable<SootSimConfig['modules']> = {}
+function parseOpenRuntimeConfig(args: string[]): RNXConfig | undefined {
+  const modules: NonNullable<RNXConfig['modules']> = {}
   const remap: Record<string, string> = {}
 
   for (let i = 0; i < args.length; i++) {
@@ -516,7 +517,7 @@ function parseOpenRuntimeConfig(args: string[]): SootSimConfig | undefined {
     }
   }
 
-  const config: SootSimConfig = {}
+  const config: RNXConfig = {}
   if (Object.keys(modules).length > 0) config.modules = modules
   if (Object.keys(remap).length > 0) config.network = { remap }
   return config.modules || config.network ? config : undefined
@@ -533,7 +534,7 @@ async function resolveOpenAppProject(
 async function ensureConfiguredRuntime(version: string): Promise<void> {
   if (fs.existsSync(path.join(runtimeDir(version), 'index.html'))) return
   console.error(`  installing configured engine runtime ${version}...`)
-  const result = await sootsimRuntime.install({
+  const result = await rnxRuntime.install({
     version,
     setActive: false,
     protectVersions: readLiveRuntimeVersions(),
@@ -940,7 +941,7 @@ export function printConnectedSims(sims: BridgeSimInfo[], selectedId?: string) {
 }
 
 // classify which engine a sim is running so dev-vs-published is never ambiguous
-// to agents or humans reading `sootsim list`. dev shell serves local source on
+// to agents or humans reading `rnx list`. dev shell serves local source on
 // :5173; the Contrast app embeds sootsim on :3000; the bridge/daemon and the
 // /__soot plugin serve the active runtime dir — which, inside a dev checkout, is
 // the fresh dev-stack build (resolveDevCheckoutRuntimeRoot mode boundary), not a
@@ -1194,7 +1195,7 @@ function resolveTargetSim(sims: BridgeSimInfo[], requestedId?: string): BridgeSi
   throw new Error('no sim connected')
 }
 
-function printOpenedSim(
+export function printOpenedSim(
   openUrl: string,
   sim: BridgeSimInfo,
   mode:
@@ -1209,10 +1210,23 @@ function printOpenedSim(
     if (!value) return value
     try {
       const parsed = new URL(value)
-      if (parsed.searchParams.has('sootsimConfig')) {
-        parsed.searchParams.set('sootsimConfig', '[redacted]')
-        return parsed.toString()
+      let changed = false
+      if (parsed.searchParams.has(RNX_CONFIG_QUERY_PARAM)) {
+        parsed.searchParams.set(RNX_CONFIG_QUERY_PARAM, '[redacted]')
+        changed = true
       }
+      const bundle = parsed.searchParams.get('bundle')
+      if (bundle) {
+        try {
+          const parsedBundle = new URL(bundle)
+          if (parsedBundle.searchParams.has(RNX_CONFIG_QUERY_PARAM)) {
+            parsedBundle.searchParams.set(RNX_CONFIG_QUERY_PARAM, '[redacted]')
+            parsed.searchParams.set('bundle', parsedBundle.toString())
+            changed = true
+          }
+        } catch {}
+      }
+      if (changed) return parsed.toString()
     } catch {}
     return value
   })
@@ -1234,7 +1248,7 @@ function printOpenedSim(
 // bounded — a cold guest bundle takes 5-15s to fully route, so we don't
 // try to wait for that. instead: settle for a moment to let the first
 // paint land, then describe whatever's on screen. for cold loads that's
-// a splash; the caller can `sootsim describe` again a second later. for
+// a splash; the caller can `rnx describe` again a second later. for
 // warm loads it's the real screen. guarded by --no-describe.
 async function maybeDescribeAfterOpen(wsPort: number, simId: string, args: string[]) {
   if (args.includes('--no-describe')) return
@@ -1244,7 +1258,7 @@ async function maybeDescribeAfterOpen(wsPort: number, simId: string, args: strin
     // brief settle, then dump the tree directly. don't go through
     // runDescribeSubcommand — its screen-transition wait can block for many
     // seconds on a still-routing guest app, which is exactly what we want
-    // to skip for the open-side describe. caller can `sootsim describe`
+    // to skip for the open-side describe. caller can `rnx describe`
     // again later for post-routing state.
     await waitForTreeStable(wsPort, simId, { stableMs: 150, maxMs: 400 })
     const bridge = createBridge(wsPort, {
@@ -1467,10 +1481,10 @@ export async function runOpenCommand(
     ? await resolveConnectionInputForCli(target)
     : undefined
   const project = await resolveOpenAppProject(resolvedBundle)
-  const appConfig = await loadSootSimAppConfig(project)
+  const appConfig = await loadRNXAppConfig(project)
   const configuredRuntimeVersion = appConfig?.runtimeVersion
-  const runtimeConfig = mergeSootSimConfig(
-    mergeSootSimConfig(
+  const runtimeConfig = mergeRNXConfig(
+    mergeRNXConfig(
       appConfig ? { ...appConfig, runtimeVersion: undefined } : undefined,
       opts.runtimeConfig,
     ),
@@ -1609,7 +1623,7 @@ export async function runOpenCommand(
         if (!targetSim && parsed.simIdSource !== 'flag') {
           targetShellUrl = await buildShellUrl(
             target,
-            applySootSimConfigToUrl(baseUrl, runtimeConfig),
+            applyRNXConfigToUrl(baseUrl, runtimeConfig),
             buildShellUrlOpts,
           )
           const normalizedTarget = new URL(targetShellUrl)
@@ -1648,7 +1662,7 @@ export async function runOpenCommand(
             targetShellUrl ??
             (await buildShellUrl(
               target,
-              applySootSimConfigToUrl(resolvedBaseUrl, runtimeConfig),
+              applyRNXConfigToUrl(resolvedBaseUrl, runtimeConfig),
               buildShellUrlOpts,
             ))
           bridge
@@ -1692,7 +1706,7 @@ export async function runOpenCommand(
           targetShellUrl ??
           (await buildShellUrl(
             target,
-            applySootSimConfigToUrl(resolvedBaseUrl, runtimeConfig),
+            applyRNXConfigToUrl(resolvedBaseUrl, runtimeConfig),
             buildShellUrlOpts,
           ))
         printOpenedSim(shellUrl, { ...targetSim, url: shellUrl }, 'current sim', quiet)
@@ -1704,7 +1718,7 @@ export async function runOpenCommand(
     }
   }
 
-  const configuredBaseUrl = applySootSimConfigToUrl(baseUrl, runtimeConfig)
+  const configuredBaseUrl = applyRNXConfigToUrl(baseUrl, runtimeConfig)
   const token = `cli-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`
   const openUrl = await buildOpenUrl(target, configuredBaseUrl, token, buildShellUrlOpts)
   const ownerPid = getStableOwnerPid()
@@ -1796,7 +1810,7 @@ async function runUseLikeCommand(args: string[], opts: ControlCommandOptions = {
       // `use`/`focus` retarget the CLI at a sim — silently grabbing one a
       // human is actively driving is the same footgun `claim` guards against,
       // so honor the lock here too (this command historically did not, which
-      // let `sootsim use <id>` steal the user's live tab).
+      // let `rnx use <id>` steal the user's live tab).
       if (target.lockedBy && target.lockExpiresAt && target.lockExpiresAt > Date.now()) {
         const secs = Math.max(0, Math.round((target.lockExpiresAt - Date.now()) / 1000))
         if (target.lockedByKind === 'user-active') {
@@ -1817,7 +1831,7 @@ async function runUseLikeCommand(args: string[], opts: ControlCommandOptions = {
             `  refused: ${target.id} is leased by ${target.lockedBy} (${secs}s)`,
           )
           console.error(
-            `  \`sootsim use ${target.id} --force\` to take it, or \`rnx open --new\` for a fresh sim`,
+            `  \`rnx use ${target.id} --force\` to take it, or \`rnx open --new\` for a fresh sim`,
           )
           rnxExit(1)
         }

package/cli/commands/cpu-profile.ts

@@ -1,4 +1,4 @@
-// sootsim perf cpu — capture a sampled CPU trace from the tenant worker.
+// rnx perf cpu — capture a sampled CPU trace from the tenant worker.
 //
 // the JS Self-Profiler API (`new Profiler()`) cannot be constructed in a
 // dedicated-worker scope, and sootsim runs the guest app in the tenant worker,
@@ -15,8 +15,8 @@
 // it stays driveable over the WS bridge, so you can scroll/navigate while
 // profiling (the playwright driver passes --remote-debugging-port through):
 //
-//   sootsim open <metro-port> --new --driver playwright --cdp-port 9222
-//   sootsim perf cpu --cdp-port 9222 --match <metro-port> --duration 5
+//   rnx open <metro-port> --new --driver playwright --cdp-port 9222
+//   rnx perf cpu --cdp-port 9222 --match <metro-port> --duration 5
 //
 // (a standalone CDP Chrome also works for profiling a static page, but it
 // does NOT register on the bridge, so it can't be driven — see printNoCdp.)
@@ -109,13 +109,13 @@ export async function runCpuProfile(
   }
   const sampleInterval = Number(valueOf(args, '--sample-interval') ?? '0.1') // ms
   const cdpPort = Number(
-    valueOf(args, '--cdp-port') ?? process.env.SOOTSIM_CDP_PORT ?? '9222',
+    valueOf(args, '--cdp-port') ?? process.env.RNX_CDP_PORT ?? '9222',
   )
   // optional substring filter to pick the right page when several sims share
   // the CDP browser (e.g. `--match 8089` or `--match /rn/8089`).
   const match = valueOf(args, '--match') ?? '/rn/'
   const outputArg = valueOf(args, '--output') ?? valueOf(args, '-o')
-  const outputPath = resolve(process.cwd(), outputArg ?? '/tmp/sootsim.cpuprofile')
+  const outputPath = resolve(process.cwd(), outputArg ?? '/tmp/rnx.cpuprofile')
 
   // locate the page target on the CDP endpoint. NOTE: Chrome's DevTools HTTP
   // `/json` endpoints reject any Host header that isn't `localhost` (a
@@ -222,7 +222,7 @@ function printNoCdp(cdpPort: number) {
   console.error('')
   console.error('    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \\')
   console.error(
-    `      --remote-debugging-port=${cdpPort} --user-data-dir=/tmp/sootsim-cdp \\`,
+    `      --remote-debugging-port=${cdpPort} --user-data-dir=/tmp/rnx-cdp \\`,
   )
   console.error('      --no-sandbox --disable-gpu-sandbox \\')
   // never suggest swiftshader — software rendering pegs every core for the
@@ -231,7 +231,7 @@ function printNoCdp(cdpPort: number) {
   console.error('      --use-gl=angle --use-angle=metal \\')
   console.error('      "http://localhost:5173/rn/<metro-port>" &')
   console.error('')
-  console.error('  override the port with --cdp-port or $SOOTSIM_CDP_PORT.')
+  console.error('  override the port with --cdp-port or $RNX_CDP_PORT.')
 }
 
 function shortUrl(url: string): string {

package/cli/commands/daemon-mac-app.ts

@@ -1,4 +1,4 @@
-// generate + ad-hoc sign the SootSim Daemon.app wrapper that the launchd
+// generate + ad-hoc sign the RNX Daemon.app wrapper that the launchd
 // agent points its ProgramArguments at.
 //
 // why this exists: macOS Background Task Management (the "X wants to run in
@@ -7,11 +7,11 @@
 // pointed at bun directly the entry shows "software from Jarred Sumner"
 // because that's bun's code-signing identity. wrapping the real invocation
 // in an ad-hoc-signed `.app` lets BTM read CFBundleDisplayName from the
-// bundle Info.plist instead, so the entry reads "SootSim Daemon".
+// bundle Info.plist instead, so the entry reads "RNX Daemon".
 //
 // the bundle is regenerated every time `daemonInstall` runs — it's tiny
 // (a plist + a shell launcher) and the launcher embeds a snapshot of the
-// invocation, so an `npm update -g sootsim` followed by `sootsim daemon
+// invocation, so an `npm update -g sootsim` followed by `rnx daemon
 // install --force` is the documented upgrade path. there's no notarization
 // or Developer ID signing here yet; ad-hoc + hardened runtime is enough to
 // fix the attribution, and a real signed bundle (shipped via the runtime
@@ -27,7 +27,7 @@ import {
 } from '../../src/home-paths'
 
 const BUNDLE_IDENTIFIER = 'dev.sootsim.daemon'
-const BUNDLE_DISPLAY_NAME = 'SootSim Daemon'
+const BUNDLE_DISPLAY_NAME = 'RNX Daemon'
 // kept in sync with package.json on release. exact value doesn't matter for
 // BTM display — macOS only reads it for "About this app" surfaces — so we
 // hardcode it rather than reach back into the package.json from a runtime
@@ -49,7 +49,7 @@ export interface DaemonAppPaths {
   launcherPath: string
 }
 
-/** rebuild ~/.sootsim/daemon-app/SootSim Daemon.app/ for the given invocation
+/** rebuild ~/.rnx/daemon-app/RNX Daemon.app/ for the given invocation
  *  and re-sign it ad-hoc. safe to call repeatedly; the directory is wiped
  *  before write so stale state from earlier installs can't leak through. */
 export function ensureDaemonApp(
@@ -103,7 +103,7 @@ function renderInfoPlist(): string {
 <dict>
   <key>CFBundleDevelopmentRegion</key><string>en</string>
   <key>CFBundleDisplayName</key><string>${BUNDLE_DISPLAY_NAME}</string>
-  <key>CFBundleExecutable</key><string>sootsim-daemon</string>
+  <key>CFBundleExecutable</key><string>rnx-daemon</string>
   <key>CFBundleIdentifier</key><string>${BUNDLE_IDENTIFIER}</string>
   <key>CFBundleInfoDictionaryVersion</key><string>6.0</string>
   <key>CFBundleName</key><string>${BUNDLE_DISPLAY_NAME}</string>
@@ -142,7 +142,7 @@ function renderLauncherScript(
   const stdout = shellSingleQuote(logDir.stdout)
   const stderr = shellSingleQuote(logDir.stderr)
   return `#!/bin/sh
-# sootsim daemon launcher generated by 'rnx daemon install'.
+# rnx daemon launcher generated by 'rnx daemon install'.
 # launchd spawns this; we exec the real rnx invocation in place so
 # launchd tracks the daemon process, not the shell wrapper.
 #

package/cli/commands/daemon.ts

@@ -1,16 +1,16 @@
-// sootsim daemon — manage the persistent sootsim bridge daemon
+// rnx daemon — manage the persistent sootsim bridge daemon
 //
-// wraps `sootsim serve` so it starts automatically on login and restarts if
+// wraps `rnx serve` so it starts automatically on login and restarts if
 // it crashes. the agent is tied to whichever `sootsim` binary resolves at
-// registration time, so `npm update -g sootsim` + `sootsim daemon restart`
+// registration time, so `npm update -g sootsim` + `rnx daemon restart`
 // picks up the upgrade without touching the plist/unit file.
 //
 // `daemonInstall` is shared by `rnx setup` and the explicit
-// `sootsim daemon install` machine-bootstrap path.
+// `rnx daemon install` machine-bootstrap path.
 //
 //   macOS:  ~/Library/LaunchAgents/dev.sootsim.daemon.plist (launchd)
 //   linux:  ~/.config/systemd/user/sootsim-daemon.service (systemd --user)
-//   win:    not yet supported — use `sootsim serve` in a persistent shell.
+//   win:    not yet supported — use `rnx serve` in a persistent shell.
 //
 // the macOS launchd Label is `dev.sootsim.daemon` (matching the .app
 // CFBundleIdentifier).
@@ -33,7 +33,7 @@ import {
   isDaemonLockfileFresh,
   readDaemonLockfile,
   shouldSkipPersistentDaemon,
-  sootsimHomeDir,
+  rnxHomeDir,
 } from '../../src/home-paths'
 import { rnxPublicBrand } from '../../src/public-brand'
 import { printCommandHelp } from '../help'
@@ -511,7 +511,7 @@ export function teardownLegacyMacDaemonArtifacts(
 
 /** stop + disable + remove the persistent launchd / systemd registration
  *  and its support files (mac .app bundle, log dir). does NOT touch user
- *  data under ~/.sootsim. idempotent: each entry is checked before remove.
+ *  data under ~/.rnx. idempotent: each entry is checked before remove.
  *  exported for reuse by the npm preuninstall hook (scripts/preuninstall.cjs)
  *  via the bundled CLI so a `npm rm -g sootsim` tears down the daemon before
  *  the bin disappears. */
@@ -571,12 +571,12 @@ export function teardownDaemonService(): TeardownReport {
   return { removed, missing: true }
 }
 
-/** remove the user-data cache under ~/.sootsim (runtimes, electron support,
- *  profiles, lockfile, config). idempotent. honors $SOOTSIM_HOME. exported
+/** remove the user-data cache under ~/.rnx (runtimes, electron support,
+ *  profiles, lockfile, config). idempotent. honors $RNX_HOME. exported
  *  for reuse by the npm preuninstall hook. */
 export function teardownSootsimHome(): TeardownReport {
   const removed: string[] = []
-  const home = sootsimHomeDir()
+  const home = rnxHomeDir()
   if (existsSync(home)) {
     rmSync(home, { recursive: true, force: true })
     removed.push(home)

package/cli/commands/debug.ts

@@ -1,20 +1,20 @@
-// sootsim debug — drive __sootsimDebug.* from the terminal
+// rnx debug — drive __sootsimDebug.* from the terminal
 //
 // connects to a running sootsim instance via the WebSocket bridge and forwards
 // debug channel management, tree snapshots, and on-demand inspectors without
 // requiring a browser console.
 //
 // usage examples:
-//   sootsim debug enable sheets,portals,onlayout
-//   sootsim debug status
-//   sootsim debug snapshot before
+//   rnx debug enable sheets,portals,onlayout
+//   rnx debug status
+//   rnx debug snapshot before
 //   # ... tap something in the UI ...
-//   sootsim debug snapshot after
-//   sootsim debug diff before after
-//   sootsim debug find sheets
-//   sootsim debug find portals
-//   sootsim debug recent portals
-//   sootsim debug flags
+//   rnx debug snapshot after
+//   rnx debug diff before after
+//   rnx debug find sheets
+//   rnx debug find portals
+//   rnx debug recent portals
+//   rnx debug flags
 //
 // all commands print JSON by default so they pipe cleanly into jq.
 
@@ -320,7 +320,7 @@ function readNumberFlag(args: string[], flag: string): number | null {
 
 // enable the audit, force one real frame, then read and stop. the screenshot
 // request is what forces the frame: it runs the same publish-and-paint pass
-// `sootsim screenshot` does, so the rows describe pixels that were actually
+// `rnx screenshot` does, so the rows describe pixels that were actually
 // produced rather than a tree walk's guess about them.
 async function runImageAudit(bridge: WsBridge): Promise<ImageAuditReportView> {
   await call(

package/cli/commands/detox.ts

@@ -45,7 +45,7 @@ rnx detox — run detox-style tests against an rnx shell
 usage:
   rnx detox [testFiles...]        run all tests under e2e/, test/e2e/, or detox/
   rnx detox --config <path>       use a specific jest config
-  rnx detox init                  scaffold sootsim-detox.config.cjs + sample test
+  rnx detox init                  scaffold rnx-detox.config.cjs + sample test
   rnx detox --watch               jest watch mode
   rnx detox --headed              keep the rnx shell window visible
   rnx detox -t <pattern>          pass a jest --testNamePattern
@@ -106,11 +106,11 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
     return []
   })
 
-  // test dir discovery. external test suites set SOOTSIM_TEST_DIR; otherwise
+  // test dir discovery. external test suites set RNX_TEST_DIR; otherwise
   // we auto-detect the conventional locations.
   const detoxDirs = ['e2e', 'test/e2e', 'detox']
-  let testDir: string | null = process.env.SOOTSIM_TEST_DIR
-    ? resolve(process.cwd(), process.env.SOOTSIM_TEST_DIR)
+  let testDir: string | null = process.env.RNX_TEST_DIR
+    ? resolve(process.cwd(), process.env.RNX_TEST_DIR)
     : null
   if (!testDir) {
     for (const dir of detoxDirs) {
@@ -131,18 +131,18 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
 
   // auto-launch: make sure a sootsim shell is reachable before running jest.
   // Reuse the Maestro discovery path: scan local dev servers.
-  // and `sootsim open` the first match.
+  // and `rnx open` the first match.
   if (!noLaunch) {
     await ensureShellRunning(port)
   }
 
   // build the jest command. prefer the user's config if they passed --config
-  // or if a sootsim-detox.config.cjs exists in cwd. otherwise point at our
+  // or if a rnx-detox.config.cjs exists in cwd. otherwise point at our
   // preset directly via --preset-free inline config.
   const jestArgs: string[] = ['jest']
   const localConfig =
     configFlag ||
-    firstExisting(['sootsim-detox.config.cjs', 'jest.config.cjs', 'jest.config.js'])
+    firstExisting(['rnx-detox.config.cjs', 'jest.config.cjs', 'jest.config.js'])
 
   let tempConfig: string | null = null
   if (localConfig) {
@@ -154,7 +154,7 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
     // scope roots + testMatch to the discovered test dir so jest doesn't
     // scan the entire repo (which causes haste collisions in monorepos).
     const presetPath = resolve(resolveDetoxDir(), 'jest-preset.cjs')
-    tempConfig = join(tmpdir(), `sootsim-detox-${process.pid}.config.cjs`)
+    tempConfig = join(tmpdir(), `rnx-detox-${process.pid}.config.cjs`)
     const cfg = {
       rootDir: testDir,
       roots: ['<rootDir>'],
@@ -183,7 +183,7 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
   if (process.env.SOOTSIM_JEST_OUTPUT_FILE) {
     jestArgs.push('--outputFile', process.env.SOOTSIM_JEST_OUTPUT_FILE)
   } else if (wantsRegistration) {
-    resultsFile = join(tmpdir(), `sootsim-detox-results-${process.pid}.json`)
+    resultsFile = join(tmpdir(), `rnx-detox-results-${process.pid}.json`)
     jestArgs.push('--json', '--outputFile', resultsFile)
   }
 
@@ -218,10 +218,10 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
     stdio: 'inherit',
     env: {
       ...process.env,
-      SOOTSIM_TEST_DIR: testDir,
+      RNX_TEST_DIR: testDir,
       SOOTSIM_PORT: String(port),
       SOOTSIM_HEADED: headed ? '1' : '',
-      SOOTSIM_URL: process.env.SOOTSIM_URL || `http://localhost:${port}`,
+      RNX_URL: process.env.RNX_URL || `http://localhost:${port}`,
     },
   })
 
@@ -355,7 +355,7 @@ async function ensureShellRunning(port: number): Promise<void> {
 
 function initDetoxProject(): void {
   const cwd = process.cwd()
-  const configPath = resolve(cwd, 'sootsim-detox.config.cjs')
+  const configPath = resolve(cwd, 'rnx-detox.config.cjs')
   if (existsSync(configPath)) {
     console.log(`  skip: ${configPath} already exists`)
   } else {
@@ -385,7 +385,7 @@ module.exports = {
     writeFileSync(
       samplePath,
       `// sample rnx detox test. resolve \`detox\` via the jest preset in
-// sootsim-detox.config.cjs — no extra imports required.
+// rnx-detox.config.cjs — no extra imports required.
 
 import { by, device, element, expect, waitFor } from 'detox'
 

package/cli/commands/diagnose.ts

@@ -1,4 +1,4 @@
-// sootsim get diagnosis — composed read commands for "what just went wrong?"
+// rnx get diagnosis — composed read commands for "what just went wrong?"
 //
 // the demo-friendly compact diagnostic surface called out in
 // plans/expensify-sootsim-agent-device-demo.md. one command, one round
@@ -6,12 +6,12 @@
 // sed/grep workflow in both speed and information density.
 //
 // usage:
-//   sootsim get diagnosis [--since 90s] [--include react,network,console,screen,fetch,alert]
-//   sootsim get diagnosis --json
+//   rnx get diagnosis [--since 90s] [--include react,network,console,screen,fetch,alert]
+//   rnx get diagnosis --json
 //
 // the output is grouped by source (timeline, network, react, console)
 // rather than chronological. for chronological order use
-// `sootsim what-happened` directly. `recent` is the only subcommand
+// `rnx what-happened` directly. `recent` is the only subcommand
 // today; `diagnose <something-else>` may be added later (e.g. boot,
 // scrolling-jank, idle-burn).
 //
@@ -315,7 +315,7 @@ function formatNetworkRow(entry: NetworkEntry): string {
   const dur = entry.durationMs != null ? `${entry.durationMs.toFixed(0)}ms` : '...'
   const url = entry.displayUrl ?? entry.url
   // shorten long urls to 96 chars in the diagnose report — full
-  // detail is one `sootsim network get <id>` away.
+  // detail is one `rnx network get <id>` away.
   const shortUrl = url.length > 96 ? `${url.slice(0, 92)}…` : url
   return `    ${status.padStart(3)} ${method} ${dur.padStart(7)}  ${shortUrl}  (${entry.id})`
 }
@@ -575,7 +575,7 @@ export async function runDiagnose(
     // a bridge call rejecting (most commonly "no sim connected") must not
     // escape as a raw stack trace with a 0 exit code — `get diagnosis` is the
     // "what just went wrong" command; failing it should read cleanly and
-    // exit non-zero so `sootsim get diagnosis && …` chains behave.
+    // exit non-zero so `rnx get diagnosis && …` chains behave.
     const msg = err instanceof Error ? err.message : String(err)
     if (/no sim connected/i.test(msg)) {
       console.error('  no sim connected — open one first: rnx open <metroPort>')

package/cli/commands/do-chain.ts

@@ -318,8 +318,7 @@ export async function runDoChain(
   const { isAgentEnv } = envModule
   const { resolveTargetCoords } = targetModule
   const wantsJson = args.includes('--json')
-  const skipSettle =
-    args.includes('--no-wait') || process.env.SOOTSIM_NO_AUTO_WAIT === '1'
+  const skipSettle = args.includes('--no-wait') || process.env.RNX_NO_AUTO_WAIT === '1'
   const parsed = parseBridgeCliArgs(args, {
     port: opts.port,
     commandTimeoutMs: 30_000,

package/cli/commands/electron.ts

@@ -68,9 +68,7 @@ examples:
   if (!install) {
     printMissingCompanionHint()
     const canPrompt =
-      process.stdin.isTTY &&
-      process.env.CI !== '1' &&
-      process.env.SOOTSIM_NO_PROMPT !== '1'
+      process.stdin.isTTY && process.env.CI !== '1' && process.env.RNX_NO_PROMPT !== '1'
     if (canPrompt && (await confirm('run rnx desktop install now?', true))) {
       console.log()
       const { runInstallDesktop } = await import('./install-desktop')

package/cli/commands/film.ts

@@ -1,4 +1,4 @@
-// sootsim film — record a flow on the flat canvas, then re-play that
+// rnx film — record a flow on the flat canvas, then re-play that
 // recording on the 3d device stage under a camera cinematic and capture the
 // stage as video.
 //
@@ -82,7 +82,7 @@ how it works:
 
 options:
   --out <path>           output file (.webm, or .mp4 when ffmpeg is
-                         installed). default: ~/Desktop/sootsim-films/<flow>.webm
+                         installed). default: ~/Desktop/rnx-films/<flow>.webm
   --script <id>          camera script to animate during playback
                          (default: hero-arc)
   --fps <n>              stage capture framerate (default: 30)
@@ -116,7 +116,7 @@ examples:
   const flowName = flowPath.replace(/^.*\//, '').replace(/\.ya?ml$/, '')
   const outArg = flagValue(args, '--out')
   const outPath = resolve(
-    outArg ?? join(homedir(), 'Desktop', 'sootsim-films', `${flowName}.webm`),
+    outArg ?? join(homedir(), 'Desktop', 'rnx-films', `${flowName}.webm`),
   )
   const wantsMp4 = extname(outPath).toLowerCase() === '.mp4'
   if (wantsMp4 && spawnSync('ffmpeg', ['-version']).status !== 0) {