rnxsim 0.1.376 → 0.1.378

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.376 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.378 | (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;
@@ -126,17 +126,17 @@ function launchRnxDesktop(bundleUrl, appName) {
 var import_node_fs2 = __toESM(require("node:fs"), 1);
 var import_node_os = require("node:os");
 var import_node_path2 = __toESM(require("node:path"), 1);
-var SOOTSIM_HOME_ENV = "SOOTSIM_HOME";
+var RNX_HOME_ENV = "RNX_HOME";
 var ACTIVE_RUNTIME_FILE = "active";
 var DAEMON_LOCKFILE = "daemon.json";
 var DAEMON_HEARTBEAT_STALE_MS = 3e4;
-function sootsimHomeDir() {
-  const override = process.env[SOOTSIM_HOME_ENV];
+function rnxHomeDir() {
+  const override = process.env[RNX_HOME_ENV];
   if (override && override.length > 0) return import_node_path2.default.resolve(override);
-  return import_node_path2.default.join((0, import_node_os.homedir)(), ".sootsim");
+  return import_node_path2.default.join((0, import_node_os.homedir)(), ".rnx");
 }
 function runtimesDir() {
-  return import_node_path2.default.join(sootsimHomeDir(), "runtimes");
+  return import_node_path2.default.join(rnxHomeDir(), "runtimes");
 }
 function runtimeDir(version) {
   return import_node_path2.default.join(runtimesDir(), version);
@@ -145,7 +145,7 @@ function activeRuntimeFile() {
   return import_node_path2.default.join(runtimesDir(), ACTIVE_RUNTIME_FILE);
 }
 function daemonLockfilePath() {
-  return import_node_path2.default.join(sootsimHomeDir(), DAEMON_LOCKFILE);
+  return import_node_path2.default.join(rnxHomeDir(), DAEMON_LOCKFILE);
 }
 function readActiveRuntime() {
   try {
@@ -417,7 +417,7 @@ function findMonorepoRoot() {
   return null;
 }
 function resolveDevCheckoutRuntimeRoot() {
-  if (process.env.SOOTSIM_HOME && readActiveRuntime()) return null;
+  if (process.env.RNX_HOME && readActiveRuntime()) return null;
   const root = findMonorepoRoot();
   if (!root) return null;
   const devBuild = import_path.default.join(root, "public/sootsim");
@@ -654,7 +654,7 @@ function rnxPlugin(options = {}) {
       const port = configuredPort;
       const sootsimUrl = `http://localhost:${port}${prefix}/`;
       console.log(`[rnx] serving at ${sootsimUrl}`);
-      if (appName && !process.env.CI && !process.env.SOOTSIM_NO_OPEN) {
+      if (appName && !process.env.CI && !process.env.RNX_NO_OPEN) {
         server.httpServer?.once("listening", () => {
           const openPort = listeningPort();
           launchRnxDesktop(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rnxsim",
-  "version": "0.1.376",
+  "version": "0.1.378",
   "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",
@@ -179,12 +179,7 @@
     },
     "./package.json": "./package.json"
   },
-  "bin": {
-    "rnx": "dist-cli/bin.js",
-    "rnxsim": "dist-cli/bin.js"
-  },
   "files": [
-    "dist-cli/",
     "dist-lib/",
     "src/",
     "cli/",
@@ -192,8 +187,6 @@
     "scripts/dev-server-scanner.ts",
     "scripts/optional-demo-registry.ts",
     "detox/",
-    "scripts/postinstall.cjs",
-    "scripts/preuninstall.cjs",
     "README.md",
     "LICENSE"
   ],
@@ -201,9 +194,9 @@
     "build": "bun scripts/build-cli.ts",
     "build:cli": "bun scripts/build-cli.ts",
     "build:cli-binary": "bun scripts/build-cli-binary.ts",
-    "pack:smoke": "bun scripts/pack-smoke.ts",
-    "postinstall": "node ./scripts/postinstall.cjs",
-    "preuninstall": "node ./scripts/preuninstall.cjs"
+    "smoke:cli-binary": "bun scripts/smoke-cli-binary.ts",
+    "publish:cli-binary": "bun scripts/publish-cli-binaries.ts",
+    "pack:smoke": "bun scripts/pack-smoke.ts"
   },
   "dependencies": {
     "@expo/plist": "^0.5.4",

package/scripts/dev-server-scanner.ts

@@ -24,7 +24,7 @@ import {
   LOOPBACK_PROBE_HOSTNAMES,
   normalizeHostname,
 } from '../src/backend-origin.ts'
-import { applySootSimConfigToUrl } from '../src/config.ts'
+import { applyRNXConfigToUrl } from '../src/config.ts'
 import {
   alignLoopbackBundleUrlWithProbe,
   normalizeNativeDevBundleUrl,
@@ -571,7 +571,7 @@ function withRuntimeConfig(port: number, bundleUrl: string, projectCwd?: string)
         ? knownApps[0]
         : undefined
   const configured = knownApp?.runtimeConfig
-    ? applySootSimConfigToUrl(bundleUrl, knownApp.runtimeConfig)
+    ? applyRNXConfigToUrl(bundleUrl, knownApp.runtimeConfig)
     : bundleUrl
   return normalizeNativeDevBundleUrl(configured)
 }

package/scripts/optional-demo-registry.ts

@@ -63,7 +63,7 @@ export interface OptionalDemoApp {
   dir: string
   preferredPort: number
   framework: 'expo' | 'one' | 'rock'
-  runtimeConfig?: import('../src/config.ts').SootSimConfig
+  runtimeConfig?: import('../src/config.ts').RNXConfig
 }
 
 let cached: OptionalDemoApp[] | null = null

package/skills/contrast/SKILL.md

@@ -60,7 +60,7 @@ automation, inspecting the render tree, and managing sims.
 | `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 |
-| `rnx runtime` | manage engine runtimes under ~/.sootsim/runtimes/ |
+| `rnx runtime` | manage engine runtimes under ~/.rnx/runtimes/ |
 | `rnx auth` | inspect active CLI auth |
 | `rnx login` | sign in for preview uploads |
 | `rnx logout` | clear the local desktop auth session |
@@ -115,7 +115,7 @@ commands in your own `sleep` or chain `do settle` "just to be safe"**.
   `type-into`, `key`, `key-sequence`, `keycode`, `drag`, `swipe`,
   `long-press`, `touch`, `gesture`, `pinch`, `scroll`, `shell`)
   the CLI polls the layout hash until it is stable for two consecutive
-  frames. budget: **400 ms for agents** (`SOOTSIM_AGENT=1`, set by the
+  frames. budget: **400 ms for agents** (`RNX_AGENT=1`, set by the
   harness), 200 ms for humans.
 
 what this means:
@@ -126,7 +126,7 @@ what this means:
   `⚠ auto-wait timed out after Nms — next command may see mid-animation
   state`, or when the transition you care about lasts longer than ~400 ms
   (full stack navigation, crossfades, video load).
-- opt-out: `--no-wait` on a single command, `SOOTSIM_NO_AUTO_WAIT=1`
+- opt-out: `--no-wait` on a single command, `RNX_NO_AUTO_WAIT=1`
   for a whole lane.
 - if a read keeps racing its write, the fix is **never** a blind `sleep` —
   prefer `wait selector`, `wait ready`, `wait idle`, or a longer

package/skills/rnx-debug/SKILL.md

@@ -129,7 +129,7 @@ rnx do settle 5                # wait up to 5s for layout stability
 rnx wait idle --max-ms 5000    # same thing under the `wait` verb
 rnx wait idle --strict         # also require animation flags clear
 rnx do tap-id play --no-wait   # skip auto-settle on one command
-SOOTSIM_NO_AUTO_WAIT=1 rnx ... # disable auto-settle for a lane
+RNX_NO_AUTO_WAIT=1 rnx ... # disable auto-settle for a lane
 ```
 
 ## branch — debugging

package/skills/rnx-test/SKILL.md

@@ -12,7 +12,7 @@ Detox runs existing imperative Jest suites through the rnx driver.
 > needs a connected, pinned sim. if `rnx describe` errors, load
 > `/rnx-setup` first.
 
-Set `SOOTSIM_NO_OPEN=1` before starting an app dev server for a Detox,
+Set `RNX_NO_OPEN=1` before starting an app dev server for a Detox,
 Maestro, or iOS-only pass. Apps can opt into a named Electron window through
 the official Vite or Metro plugin, and test-only work must not open that window.
 
@@ -236,7 +236,7 @@ upstream detox surface.
 ### one-line install
 
 ```js
-// sootsim-detox.config.cjs
+// rnx-detox.config.cjs
 module.exports = {
   preset: 'rnxsim/detox/jest-preset',
   rootDir: __dirname,

package/src/agent-identity.ts

@@ -6,7 +6,7 @@ export function agentSessionIdFromCliIdentity(identity: string | null): string |
   if (colon < 0) return identity.trim() || null
   const source = identity.slice(0, colon)
   const value = identity.slice(colon + 1).trim()
-  return source === 'SOOTSIM_CLI_IDENTITY' && value ? value : null
+  return source === 'RNX_CLI_IDENTITY' && value ? value : null
 }
 
 export function teamMachineSessionIdFromCliIdentity(

package/src/agent-sessions.ts

@@ -67,7 +67,7 @@ export function pidIsAlive(pid: number | undefined, sessionId?: string): boolean
 
 /** figure out how to re-invoke the sootsim CLI to run `agent-wrapper`.
  *  priority:
- *    1. SOOTSIM_BIN env var (explicit override)
+ *    1. RNX_BIN env var (explicit override)
  *    2. electron prod: bundled binary under process.resourcesPath/bin/
  *    3. workspace build artifacts (dist-bin/<binary> or dist-cli/bin.js)
  *       — shared between electron dev, the vite-plugin-hosted daemon, and
@@ -77,8 +77,8 @@ export function pidIsAlive(pid: number | undefined, sessionId?: string): boolean
  *    5. CLI standalone: argv[0] is the compiled binary, no prefix needed
  */
 export function resolveSootsimInvocation(): { cmd: string; prefixArgs: string[] } {
-  if (process.env.SOOTSIM_BIN) {
-    return { cmd: process.env.SOOTSIM_BIN, prefixArgs: [] }
+  if (process.env.RNX_BIN) {
+    return { cmd: process.env.RNX_BIN, prefixArgs: [] }
   }
   // electron prod: packaged binary lives under Resources/bin/.
   if (process.versions.electron) {
@@ -117,7 +117,7 @@ export function resolveSootsimInvocation(): { cmd: string; prefixArgs: string[]
     // bin-shim case falls through to the error below instead of silently
     // running `node` without args.
     throw new Error(
-      'rnx CLI not found. set SOOTSIM_BIN to the path of the rnx binary, ' +
+      'rnx CLI not found. set RNX_BIN to the path of the rnx binary, ' +
         'or build the workspace CLI via `bun run --cwd packages/sootsim build:cli`.',
     )
   }
@@ -128,7 +128,9 @@ function tryWorkspaceSootsim(): { cmd: string; prefixArgs: string[] } | null {
   try {
     const sootsimDir = resolveSootsimPackageDir()
     if (!sootsimDir) return null
-    const binaryName = `sootsim-${process.platform}-${process.arch}`
+    const binaryName = `rnx-${
+      process.platform === 'win32' ? 'windows' : process.platform
+    }-${process.arch}${process.platform === 'win32' ? '.exe' : ''}`
     const distBinary = path.join(sootsimDir, 'dist-bin', binaryName)
     if (fs.existsSync(distBinary)) return { cmd: distBinary, prefixArgs: [] }
     const distBin = path.join(sootsimDir, 'dist-cli', 'bin.js')

package/src/cli-version.ts

@@ -1,16 +1,24 @@
-// sootsim CLI version — the `sootsim` npm package version. resolved once
-// and cached. shared by `--version`, `--help`, the `upgrade` command, the
-// startup flow, and the bridge-host (which injects it into the served
-// runtime html as window.__sootsimCliVersion).
+// rnx cli version, resolved once and cached. standalone builds embed it so
+// lazy command chunks do not depend on an npm package layout at runtime.
 
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 import { rnxPublicBrand } from './public-brand.ts'
 
+declare const __RNX_CLI_VERSION__: string
+
 let cached: string | null = null
 
 export function getCliVersion(): string {
   if (cached != null) return cached
+  if (
+    typeof __RNX_CLI_VERSION__ !== 'undefined' &&
+    typeof __RNX_CLI_VERSION__ === 'string' &&
+    __RNX_CLI_VERSION__
+  ) {
+    cached = __RNX_CLI_VERSION__
+    return cached
+  }
   // prefer package resolution (works for npm/global installs); fall back to
   // the package.json next to this module's source for repo / bundled runs.
   const candidates: Array<() => string> = [

package/src/config.ts

@@ -1,4 +1,4 @@
-// sootsim.config.ts — per-app module resolution, turbo modules, env, state, and settings.
+// rnx.config.ts — per-app module resolution, turbo modules, env, state, and settings.
 //
 // usage:
 //   import { defineConfig } from 'rnxsim/config'
@@ -17,9 +17,7 @@ export type ModuleResolution =
 
 export type NativeModuleResolution = ModuleResolution | Record<string, any> // direct native module object for non-url configs
 
-export interface SootSimConfig<
-  Settings extends Record<string, any> = Record<string, any>,
-> {
+export interface RNXConfig<Settings extends Record<string, any> = Record<string, any>> {
   // host-only engine selection. omitted means the current stable runtime.
   runtimeVersion?: string
   modules?: Record<string, ModuleResolution>
@@ -48,11 +46,11 @@ export interface SootSimConfig<
   }
 }
 
-export const SOOTSIM_CONFIG_QUERY_PARAM = 'sootsimConfig'
+export const RNX_CONFIG_QUERY_PARAM = 'rnxConfig'
 
 export function defineConfig<Settings extends Record<string, any> = Record<string, any>>(
-  config: SootSimConfig<Settings>,
-): SootSimConfig<Settings> {
+  config: RNXConfig<Settings>,
+): RNXConfig<Settings> {
   return config
 }
 
@@ -60,9 +58,9 @@ function hasOwnKeys(value: Record<string, unknown> | undefined): boolean {
   return !!value && Object.keys(value).length > 0
 }
 
-export function hasSootSimConfig<
-  Settings extends Record<string, any> = Record<string, any>,
->(config?: SootSimConfig<Settings> | null): config is SootSimConfig<Settings> {
+export function hasRNXConfig<Settings extends Record<string, any> = Record<string, any>>(
+  config?: RNXConfig<Settings> | null,
+): config is RNXConfig<Settings> {
   if (!config) return false
   return (
     (typeof config.runtimeVersion === 'string' && config.runtimeVersion.length > 0) ||
@@ -76,15 +74,15 @@ export function hasSootSimConfig<
   )
 }
 
-export function mergeSootSimConfig<
+export function mergeRNXConfig<
   Settings extends Record<string, any> = Record<string, any>,
 >(
-  base?: SootSimConfig<Settings> | null,
-  override?: SootSimConfig<Settings> | null,
-): SootSimConfig<Settings> | undefined {
-  if (!hasSootSimConfig(base) && !hasSootSimConfig(override)) return undefined
-  if (!hasSootSimConfig(base)) return override ? { ...override } : undefined
-  if (!hasSootSimConfig(override)) return base ? { ...base } : undefined
+  base?: RNXConfig<Settings> | null,
+  override?: RNXConfig<Settings> | null,
+): RNXConfig<Settings> | undefined {
+  if (!hasRNXConfig(base) && !hasRNXConfig(override)) return undefined
+  if (!hasRNXConfig(base)) return override ? { ...override } : undefined
+  if (!hasRNXConfig(override)) return base ? { ...base } : undefined
 
   return {
     runtimeVersion: override.runtimeVersion ?? base.runtimeVersion,
@@ -106,29 +104,29 @@ export function mergeSootSimConfig<
   }
 }
 
-export function readSootSimConfigFromSearchParams<
+export function readRNXConfigFromSearchParams<
   Settings extends Record<string, any> = Record<string, any>,
->(searchParams: URLSearchParams): SootSimConfig<Settings> | undefined {
-  const raw = searchParams.get(SOOTSIM_CONFIG_QUERY_PARAM)
+>(searchParams: URLSearchParams): RNXConfig<Settings> | undefined {
+  const raw = searchParams.get(RNX_CONFIG_QUERY_PARAM)
   if (!raw) return undefined
   try {
-    const parsed = JSON.parse(raw) as SootSimConfig<Settings>
-    return hasSootSimConfig(parsed) ? parsed : undefined
+    const parsed = JSON.parse(raw) as RNXConfig<Settings>
+    return hasRNXConfig(parsed) ? parsed : undefined
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error)
-    console.warn(`[rnx] invalid ${SOOTSIM_CONFIG_QUERY_PARAM}: ${message}`)
+    console.warn(`[rnx] invalid ${RNX_CONFIG_QUERY_PARAM}: ${message}`)
     return undefined
   }
 }
 
-export function applySootSimConfigToUrl<
+export function applyRNXConfigToUrl<
   Settings extends Record<string, any> = Record<string, any>,
->(url: string, config?: SootSimConfig<Settings> | null): string {
+>(url: string, config?: RNXConfig<Settings> | null): string {
   const parsed = new URL(url)
-  if (hasSootSimConfig(config)) {
-    parsed.searchParams.set(SOOTSIM_CONFIG_QUERY_PARAM, JSON.stringify(config))
+  if (hasRNXConfig(config)) {
+    parsed.searchParams.set(RNX_CONFIG_QUERY_PARAM, JSON.stringify(config))
   } else {
-    parsed.searchParams.delete(SOOTSIM_CONFIG_QUERY_PARAM)
+    parsed.searchParams.delete(RNX_CONFIG_QUERY_PARAM)
   }
   return parsed.toString()
 }

package/src/disk-cleanup.ts

@@ -1,8 +1,8 @@
 import fs from 'node:fs'
 import path from 'node:path'
 import { isDisposableBrowserCacheDir } from './browser-cache'
-import { ensureSootsimHome, readLiveRuntimeVersions, sootsimHomeDir } from './home-paths'
-import { sootsimRuntime } from './runtime-delivery'
+import { ensureRnxHome, readLiveRuntimeVersions, rnxHomeDir } from './home-paths'
+import { rnxRuntime } from './runtime-delivery'
 
 const AUTOMATIC_CLEANUP_GENERATION = 1
 const AUTOMATIC_CLEANUP_COMPLETE_FILE = `automatic-cleanup-v${AUTOMATIC_CLEANUP_GENERATION}.json`
@@ -65,7 +65,7 @@ export interface AutomaticSootsimCleanupResult {
 }
 
 export function isAutomaticSootsimCleanupComplete(): boolean {
-  const completePath = path.join(sootsimHomeDir(), AUTOMATIC_CLEANUP_COMPLETE_FILE)
+  const completePath = path.join(rnxHomeDir(), AUTOMATIC_CLEANUP_COMPLETE_FILE)
   try {
     const parsed = JSON.parse(fs.readFileSync(completePath, 'utf8')) as {
       generation?: unknown
@@ -80,7 +80,7 @@ export function isAutomaticSootsimCleanupComplete(): boolean {
 // right now. complete means never again; a recent deferral means not yet.
 export function shouldSkipAutomaticSootsimCleanup(now = Date.now()): boolean {
   if (isAutomaticSootsimCleanupComplete()) return true
-  const deferredPath = path.join(sootsimHomeDir(), AUTOMATIC_CLEANUP_DEFERRED_FILE)
+  const deferredPath = path.join(rnxHomeDir(), AUTOMATIC_CLEANUP_DEFERRED_FILE)
   try {
     const parsed = JSON.parse(fs.readFileSync(deferredPath, 'utf8')) as {
       generation?: unknown
@@ -243,11 +243,11 @@ function runtimeEntries(aggressive: boolean): {
 } {
   const inUseVersions = new Set(readLiveRuntimeVersions())
   const protectVersions = [...inUseVersions]
-  const normal = sootsimRuntime.planLocalRetention({
+  const normal = rnxRuntime.planLocalRetention({
     retainVersions: 2,
     protectVersions,
   })
-  const minimal = sootsimRuntime.planLocalRetention({
+  const minimal = rnxRuntime.planLocalRetention({
     retainVersions: 1,
     protectVersions,
   })
@@ -262,7 +262,7 @@ function runtimeEntries(aggressive: boolean): {
   const entries: SootsimCleanupEntry[] = []
 
   for (const version of [...allVersions].sort()) {
-    const runtimePath = sootsimRuntime.product.runtimeDir(version)
+    const runtimePath = rnxRuntime.product.runtimeDir(version)
     let state: SootsimCleanupState = 'retained'
     let detail = 'retained runtime'
     if (inUseVersions.has(version) && version !== normal.activeVersion) {
@@ -308,7 +308,7 @@ export function planSootsimCleanup(
   options: SootsimCleanupOptions = {},
 ): SootsimCleanupPlan {
   const aggressive = options.aggressive === true
-  const home = sootsimHomeDir()
+  const home = rnxHomeDir()
   const runtimes = runtimeEntries(aggressive)
   const entries = [
     ...runtimes.entries,
@@ -345,7 +345,7 @@ export function applySootsimCleanup(
 ): SootsimCleanupResult {
   const plan = planSootsimCleanup(options)
   const retainVersions = options.aggressive === true ? 1 : 2
-  sootsimRuntime.pruneLocalRetention({
+  rnxRuntime.pruneLocalRetention({
     retainVersions,
     protectVersions: readLiveRuntimeVersions(),
   })
@@ -386,8 +386,8 @@ export function applySootsimCleanup(
 }
 
 export function applyAutomaticSootsimCleanup(): AutomaticSootsimCleanupResult {
-  ensureSootsimHome()
-  const home = sootsimHomeDir()
+  ensureRnxHome()
+  const home = rnxHomeDir()
   const completePath = path.join(home, AUTOMATIC_CLEANUP_COMPLETE_FILE)
   const deferredPath = path.join(home, AUTOMATIC_CLEANUP_DEFERRED_FILE)
   const lockPath = path.join(home, AUTOMATIC_CLEANUP_LOCK_FILE)

package/src/home-paths.ts

@@ -1,8 +1,8 @@
-// canonical filesystem layout under ~/.sootsim/. shared by the CLI and the
+// canonical filesystem layout under ~/.rnx/. shared by the CLI and the
 // electron main process so every surface agrees where runtimes, the daemon
 // lockfile, and caches live.
 //
-//   ~/.sootsim/
+//   ~/.rnx/
 //   ├── runtimes/
 //   │   ├── <version>/     unpacked dist/ of sootsim-engine
 //   │   └── active         text file with the active version string (win-safe
@@ -12,7 +12,7 @@
 //   ├── profiles/
 //   │   └── profiles.json  storage profile metadata
 //   ├── cache/
-//   │   └── sootsim-runtime-<version>.tar.gz
+//   │   └── rnx-runtime-<version>.tar.gz
 //   ├── daemon.json        lockfile: pid, ports, active runtime, heartbeat
 //   ├── dev-bridges/       live Vite dev bridge records, keyed by bound port
 //   ├── runtime-upgraded.json  one-shot notice written by the daemon's
@@ -28,17 +28,17 @@ import fs from 'node:fs'
 import { homedir } from 'node:os'
 import path from 'node:path'
 
-export const SOOTSIM_HOME_ENV = 'SOOTSIM_HOME'
+export const RNX_HOME_ENV = 'RNX_HOME'
 export const ACTIVE_RUNTIME_FILE = 'active'
 export const DAEMON_LOCKFILE = 'daemon.json'
 export const DEV_BRIDGES_DIR = 'dev-bridges'
 export const CONFIG_FILE = 'config.json'
 export const DAEMON_HEARTBEAT_STALE_MS = 30_000
 
-export function sootsimHomeDir(): string {
-  const override = process.env[SOOTSIM_HOME_ENV]
+export function rnxHomeDir(): string {
+  const override = process.env[RNX_HOME_ENV]
   if (override && override.length > 0) return path.resolve(override)
-  return path.join(homedir(), '.sootsim')
+  return path.join(homedir(), '.rnx')
 }
 
 // detect when sootsim is running from a source checkout (the Contrast monorepo)
@@ -101,7 +101,7 @@ export function shouldSkipPersistentDaemon(): boolean {
 }
 
 export function runtimesDir(): string {
-  return path.join(sootsimHomeDir(), 'runtimes')
+  return path.join(rnxHomeDir(), 'runtimes')
 }
 
 export function runtimeDir(version: string): string {
@@ -113,7 +113,7 @@ export function activeRuntimeFile(): string {
 }
 
 export function electronDir(): string {
-  return path.join(sootsimHomeDir(), 'electron')
+  return path.join(rnxHomeDir(), 'electron')
 }
 
 export function electronUserDataDir(): string {
@@ -125,14 +125,14 @@ export function electronVersionDir(version: string): string {
 }
 
 export function profilesDir(): string {
-  return path.join(sootsimHomeDir(), 'profiles')
+  return path.join(rnxHomeDir(), 'profiles')
 }
 
 // video fixtures staged for `rnx camera play`. the CLI copies the user's
 // file in here and the daemon serves it by basename from this one directory,
 // so the route can never be talked into reading anywhere else on disk.
 export function cameraFixturesDir(): string {
-  return path.join(sootsimHomeDir(), 'camera-fixtures')
+  return path.join(rnxHomeDir(), 'camera-fixtures')
 }
 
 // the launchd-managed daemon spawns ProgramArguments[0] directly, and macOS
@@ -142,27 +142,27 @@ export function cameraFixturesDir(): string {
 // an ad-hoc-signed .app bundle here gives BTM a CFBundleDisplayName to
 // read instead.
 export function daemonAppDir(): string {
-  return path.join(sootsimHomeDir(), 'daemon-app')
+  return path.join(rnxHomeDir(), 'daemon-app')
 }
 
 export function daemonAppBundlePath(): string {
-  return path.join(daemonAppDir(), 'SootSim Daemon.app')
+  return path.join(daemonAppDir(), 'RNX Daemon.app')
 }
 
 export function daemonAppLauncherPath(): string {
-  return path.join(daemonAppBundlePath(), 'Contents', 'MacOS', 'sootsim-daemon')
+  return path.join(daemonAppBundlePath(), 'Contents', 'MacOS', 'rnx-daemon')
 }
 
 export function cacheDir(): string {
-  return path.join(sootsimHomeDir(), 'cache')
+  return path.join(rnxHomeDir(), 'cache')
 }
 
 export function daemonLockfilePath(): string {
-  return path.join(sootsimHomeDir(), DAEMON_LOCKFILE)
+  return path.join(rnxHomeDir(), DAEMON_LOCKFILE)
 }
 
 export function devBridgesDir(): string {
-  return path.join(sootsimHomeDir(), DEV_BRIDGES_DIR)
+  return path.join(rnxHomeDir(), DEV_BRIDGES_DIR)
 }
 
 export function devBridgeLockfilePath(bridgePort: number): string {
@@ -173,12 +173,12 @@ export function devBridgeLockfilePath(bridgePort: number): string {
 }
 
 export function configFilePath(): string {
-  return path.join(sootsimHomeDir(), CONFIG_FILE)
+  return path.join(rnxHomeDir(), CONFIG_FILE)
 }
 
-// --- shared sootsim config -----------------------------------------------
+// --- shared rnx config ---------------------------------------------------
 //
-// ~/.sootsim/config.json is the single user-level config file every sootsim
+// ~/.rnx/config.json is the single user-level config file every rnx
 // surface (cli, electron renderer, dev browser via electron ipc) agrees on.
 //
 // privacy preferences live in the nested settings object so the cli, desktop
@@ -207,7 +207,7 @@ export function readSharedConfig(): SharedConfig {
  *  objects (currently just `settings`) are shallow-merged so partial writes
  *  don't clobber unrelated fields. returns the new full snapshot. */
 export function writeSharedConfig(patch: Partial<SharedConfig>): SharedConfig {
-  ensureSootsimHome()
+  ensureRnxHome()
   const current = readSharedConfig()
   const next: SharedConfig = { ...current, ...patch }
   if (patch.settings && typeof patch.settings === 'object') {
@@ -300,11 +300,11 @@ export interface RuntimeUpgradeNotice {
 }
 
 export function runtimeUpgradeNoticePath(): string {
-  return path.join(sootsimHomeDir(), 'runtime-upgraded.json')
+  return path.join(rnxHomeDir(), 'runtime-upgraded.json')
 }
 
 export function writeRuntimeUpgradeNotice(notice: RuntimeUpgradeNotice): void {
-  ensureSootsimHome()
+  ensureRnxHome()
   const tmp = `${runtimeUpgradeNoticePath()}.tmp`
   fs.writeFileSync(tmp, `${JSON.stringify(notice)}\n`, 'utf8')
   fs.renameSync(tmp, runtimeUpgradeNoticePath())
@@ -328,8 +328,8 @@ export function consumeRuntimeUpgradeNotice(): RuntimeUpgradeNotice | null {
   }
 }
 
-export function ensureSootsimHome(): void {
-  fs.mkdirSync(sootsimHomeDir(), { recursive: true })
+export function ensureRnxHome(): void {
+  fs.mkdirSync(rnxHomeDir(), { recursive: true })
   fs.mkdirSync(runtimesDir(), { recursive: true })
   fs.mkdirSync(electronDir(), { recursive: true })
   fs.mkdirSync(profilesDir(), { recursive: true })
@@ -434,7 +434,7 @@ interface DaemonClaim {
 export function readDaemonLockfile(): DaemonLockfile | null {
   try {
     // cap the read so a junk/large file on the lockfile path can't OOM
-    // the CLI when someone has been messing with ~/.sootsim/.
+    // the CLI when someone has been messing with ~/.rnx/.
     const fd = fs.openSync(daemonLockfilePath(), 'r')
     try {
       const buf = Buffer.alloc(DAEMON_LOCKFILE_MAX_BYTES)
@@ -577,7 +577,7 @@ export function readLiveRuntimeVersions(): string[] {
 }
 
 export function writeDaemonLockfile(data: DaemonLockfile): void {
-  ensureSootsimHome()
+  ensureRnxHome()
   const lockfilePath = daemonLockfilePath()
   const existing = readDaemonLockfile()
   if (!existing) {
@@ -723,7 +723,7 @@ function releaseDaemonClaim(owner: Pick<DaemonLockfile, 'pid' | 'startedAt'>): v
  *  process-owned election file serializes concurrent fallback-port binds;
  *  the complete lock snapshot is then installed with an exclusive hard link. */
 export function claimDaemonLockfile(data: DaemonLockfile): boolean {
-  ensureSootsimHome()
+  ensureRnxHome()
   if (!acquireDaemonClaim(data)) return false
   try {
     const existing = readDaemonLockfile()