rnxsim 0.1.334 → 0.1.336

package/cli/commands/camera.ts

@@ -1,4 +1,4 @@
-// rnxsim camera drives the host-owned camera source. fixture video uses the
+// rnx camera drives the host-owned camera source. fixture video uses the
 // same hidden video, canvas frame pump, ImageBitmap transfer, and
 // BarcodeDetector loop as a real device camera. `do scan` remains the narrow
 // synthetic special case for callers that have a payload string but no media.
@@ -22,13 +22,13 @@ const VIDEO_EXTENSIONS = new Set(['.m4v', '.mov', '.mp4', '.webm'])
 
 function printHelp() {
   console.log(`
-rnxsim camera — control the simulator camera source
+rnx camera — control the simulator camera source
 
 usage:
-  rnxsim camera play <file> [--loop] [--rate <number>]
-  rnxsim camera stop
-  rnxsim camera status [--json]
-  rnxsim do scan <text> [--format <web-format>]
+  rnx camera play <file> [--loop] [--rate <number>]
+  rnx camera stop
+  rnx camera status [--json]
+  rnx do scan <text> [--format <web-format>]
 
 subcommands:
   play <file>   replace the active camera source with a local video fixture
@@ -45,11 +45,11 @@ options:
   --port <p>    WS bridge port (default: 7668)
 
 examples:
-  rnxsim camera play ./fixtures/qr.mp4 --loop
-  rnxsim camera play ./fixtures/document.webm --rate 2
-  rnxsim camera status
-  rnxsim camera stop
-  rnxsim do scan "https://example.com" --format qr_code
+  rnx camera play ./fixtures/qr.mp4 --loop
+  rnx camera play ./fixtures/document.webm --rate 2
+  rnx camera status
+  rnx camera stop
+  rnx do scan "https://example.com" --format qr_code
 `)
 }
 
@@ -126,7 +126,7 @@ export async function runCamera(
     if (subcommand === 'scan') {
       const text = positional[1]
       if (!text) {
-        console.error('  usage: rnxsim do scan <text>')
+        console.error('  usage: rnx do scan <text>')
         return 1
       }
       const formatFlag = args.indexOf('--format')
@@ -164,7 +164,7 @@ export async function runCamera(
     if (subcommand === 'play') {
       const input = positional[1]
       if (!input) {
-        console.error('  usage: rnxsim camera play <file> [--loop] [--rate <number>]')
+        console.error('  usage: rnx camera play <file> [--loop] [--rate <number>]')
         return 1
       }
       const sourcePath = path.resolve(input)

package/cli/commands/cleanup.ts

@@ -35,13 +35,13 @@ function summarize(entries: SootsimCleanupEntry[]): string[] {
 
 function printHelp(): void {
   console.log(`
-rnxsim cleanup — inspect and reclaim local rnx disk usage
+rnx cleanup — inspect and reclaim local rnx disk usage
 
 usage:
-  rnxsim cleanup
-  rnxsim cleanup --apply
-  rnxsim cleanup --aggressive
-  rnxsim cleanup --apply --aggressive
+  rnx cleanup
+  rnx cleanup --apply
+  rnx cleanup --aggressive
+  rnx cleanup --apply --aggressive
 
 The default is a read-only preview. --apply removes downloaded runtime archives,
 old runtimes outside a two-version rollback window, and disposable browser
@@ -151,7 +151,7 @@ export async function runCleanup(args: string[]): Promise<number> {
   console.log(`  reclaimable now: ${formatSootsimBytes(plan.reclaimableBytes)}`)
   if (!apply) {
     console.log(
-      `  preview only — run \`rnxsim cleanup --apply${
+      `  preview only — run \`rnx cleanup --apply${
         aggressive ? ' --aggressive' : ''
       }\` to remove these items`,
     )

package/cli/commands/compat.ts

@@ -19,12 +19,12 @@ interface PackageManifest {
 export async function runCompat(args: string[]): Promise<void> {
   if (args.includes('--help') || args.includes('-h')) {
     console.log(`
-rnxsim compat — check package compatibility
+rnx compat — check package compatibility
 
 usage:
-  rnxsim compat [package-name]
-  rnxsim compat --json
-  rnxsim compat --brief
+  rnx compat [package-name]
+  rnx compat --json
+  rnx compat --brief
 
 flags:
   --json       machine-readable output

package/cli/commands/config.ts

@@ -2,10 +2,10 @@ import { runTelemetry } from './telemetry'
 
 function printHelp(): void {
   console.log(`
-rnxsim config — manage local CLI preferences
+rnx config — manage local CLI preferences
 
 usage:
-  rnxsim config telemetry [on|off|status]
+  rnx config telemetry [on|off|status]
 
 environment:
   SOOTSIM_HINTS=off       suppress CLI hints

package/cli/commands/control.ts

@@ -201,7 +201,7 @@ export async function ensureBridgeForOpen(
   }
   if (lock && isDaemonLockfileFresh(lock)) {
     throw new Error(
-      `rnx bridge lockfile is fresh (port ${lock.bridgePort}) but the bridge is not reachable. run \`rnxsim daemon restart\` or \`rnxsim daemon uninstall\`.`,
+      `rnx bridge lockfile is fresh (port ${lock.bridgePort}) but the bridge is not reachable. run \`rnx daemon restart\` or \`rnx daemon uninstall\`.`,
     )
   }
 
@@ -499,18 +499,18 @@ function parseOpenRuntimeConfig(args: string[]): SootSimConfig | undefined {
     if (args[i] === '--replace') {
       const raw = args[i + 1]
       if (!raw) {
-        console.error('  rnxsim open: --replace expects <module>=<file>')
+        console.error('  rnx open: --replace expects <module>=<file>')
         process.exit(1)
       }
       const eqIndex = raw.indexOf('=')
       if (eqIndex <= 0 || eqIndex === raw.length - 1) {
-        console.error('  rnxsim open: --replace expects <module>=<file>')
+        console.error('  rnx open: --replace expects <module>=<file>')
         process.exit(1)
       }
       const moduleName = raw.slice(0, eqIndex).trim()
       const filePath = normalizeReplacementPath(raw.slice(eqIndex + 1).trim())
       if (!fs.existsSync(filePath)) {
-        console.error(`  rnxsim open: replacement file not found: ${filePath}`)
+        console.error(`  rnx open: replacement file not found: ${filePath}`)
         process.exit(1)
       }
       modules[moduleName] = { file: filePath }
@@ -524,7 +524,7 @@ function parseOpenRuntimeConfig(args: string[]): SootSimConfig | undefined {
       const raw = args[i + 1]
       const eqIndex = raw ? raw.indexOf('=') : -1
       if (!raw || eqIndex <= 0 || eqIndex === raw.length - 1) {
-        console.error('  rnxsim open: --remap expects <host:port>=<host:port>')
+        console.error('  rnx open: --remap expects <host:port>=<host:port>')
         process.exit(1)
       }
       remap[raw.slice(0, eqIndex).trim()] = raw.slice(eqIndex + 1).trim()
@@ -1302,7 +1302,7 @@ async function maybeDescribeAfterOpen(wsPort: number, simId: string, args: strin
           console.log(
             `  app still loading: ${reason} (nodes: ${readyProbe.nodes}, targets: ${readyProbe.targets})`,
           )
-          console.log('  before interacting, run: rnxsim wait ready --max-ms 120000')
+          console.log('  before interacting, run: rnx wait ready --max-ms 120000')
         }
       }
       const dumpOpts = { describe: true, verbose: false, filter: '' }
@@ -1387,8 +1387,8 @@ export async function runLinkCommand(args: string[], opts: ControlCommandOptions
     commandTimeoutMs: opts.timeoutMs,
   })
   if (parsed.positional.length !== 1) {
-    console.error('  rnxsim open: expected exactly one <url-or-route>')
-    console.error('  examples: rnxsim open /settings  |  rnxsim open myapp://settings')
+    console.error('  rnx open: expected exactly one <url-or-route>')
+    console.error('  examples: rnx open /settings  |  rnx open myapp://settings')
     process.exit(1)
   }
 
@@ -1396,7 +1396,7 @@ export async function runLinkCommand(args: string[], opts: ControlCommandOptions
   try {
     target = normalizeDeepLinkTarget(parsed.positional[0] ?? '')
   } catch (err) {
-    console.error(`  rnxsim open: ${err instanceof Error ? err.message : String(err)}`)
+    console.error(`  rnx open: ${err instanceof Error ? err.message : String(err)}`)
     process.exit(1)
   }
 
@@ -1417,9 +1417,9 @@ export async function runLinkCommand(args: string[], opts: ControlCommandOptions
   } catch (err) {
     console.error(`  link failed: ${err instanceof Error ? err.message : String(err)}`)
     await printBridgeFailureDiagnostics(bridge, {
-      errorsCommand: `rnxsim get errors 5${simHint}`,
-      warningsCommand: `rnxsim get warnings 5${simHint}`,
-      requestsCommand: `rnxsim get requests 5${simHint}`,
+      errorsCommand: `rnx get errors 5${simHint}`,
+      warningsCommand: `rnx get warnings 5${simHint}`,
+      requestsCommand: `rnx get requests 5${simHint}`,
     })
     process.exit(1)
   } finally {
@@ -1458,12 +1458,12 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
   const cdpPort = cdpPortArg ? Number(cdpPortArg) : undefined
   if (cdpPortArg && (!Number.isFinite(cdpPort) || cdpPort! <= 0)) {
     console.error(
-      `  rnxsim open: --cdp-port must be a positive port number, got "${cdpPortArg}"`,
+      `  rnx open: --cdp-port must be a positive port number, got "${cdpPortArg}"`,
     )
     process.exit(1)
   }
   if (requestedProfileId && ephemeralProfile) {
-    console.error('  rnxsim open: --profile cannot be combined with --ephemeral')
+    console.error('  rnx open: --profile cannot be combined with --ephemeral')
     process.exit(1)
   }
   const profileId = requestedProfileId ? ensureProfile(requestedProfileId).id : undefined
@@ -1471,7 +1471,7 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
   const commandConfig = parseOpenRuntimeConfig(args)
   if (openInNewSim && parsed.simIdSource === 'flag') {
     console.error(
-      '  rnxsim open: --new, --profile, and --ephemeral cannot be combined with --sim',
+      '  rnx open: --new, --profile, and --ephemeral cannot be combined with --sim',
     )
     process.exit(1)
   }
@@ -1480,7 +1480,7 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
   if (shouldOpenAsDeepLink(target)) {
     if (openInNewSim) {
       console.error(
-        '  rnxsim open: deep links target the current app; remove --new, --profile, or --ephemeral',
+        '  rnx open: deep links target the current app; remove --new, --profile, or --ephemeral',
       )
       process.exit(1)
     }
@@ -1500,7 +1500,7 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
       }
     })()
     console.log(
-      '  that’s an rnxsim preview/build link — a full player page, not a driveable sim.',
+      '  that’s an rnx preview/build link — a full player page, not a driveable sim.',
     )
     console.log('  opening it in your browser for viewing…')
     try {
@@ -1514,8 +1514,8 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
     }
     console.log(
       isLocal
-        ? '  to drive it under the CLI, point `rnxsim open` at the app’s dev port instead (e.g. `rnxsim open 8081`).'
-        : '  the CLI can’t drive a remote preview (the engine only attaches to the local bridge from localhost). to drive the app, run it locally and `rnxsim open <port>`.',
+        ? '  to drive it under the CLI, point `rnx open` at the app’s dev port instead (e.g. `rnx open 8081`).'
+        : '  the CLI can’t drive a remote preview (the engine only attaches to the local bridge from localhost). to drive the app, run it locally and `rnx open <port>`.',
     )
     return
   }
@@ -1554,9 +1554,7 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
   // native desktop surface. neither path opens the user's browser profile.
   const requestedDriverId = args.find((_, i) => args[i - 1] === '--driver') || ''
   if (requestedDriverId && !isDriverId(requestedDriverId)) {
-    console.error(
-      `  unknown driver "${requestedDriverId}" — run \`rnxsim list --drivers\``,
-    )
+    console.error(`  unknown driver "${requestedDriverId}" — run \`rnx list --drivers\``)
     process.exit(1)
   }
   const driverId: DriverId = isDriverId(requestedDriverId)
@@ -1564,7 +1562,7 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
     : 'playwright'
   const driverHeadless = resolveDriverHeadless(args, driverId)
   if (cdpPort && driverId !== 'playwright') {
-    console.error('  rnxsim open: --cdp-port is only honored by the playwright driver')
+    console.error('  rnx open: --cdp-port is only honored by the playwright driver')
     process.exit(1)
   }
 
@@ -1578,7 +1576,7 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
   const hotFlag = args.includes('--hot')
   const noHmrFlag = args.includes('--no-hmr')
   if (hotFlag && noHmrFlag) {
-    console.error('  rnxsim open: --hot and --no-hmr cannot be combined')
+    console.error('  rnx open: --hot and --no-hmr cannot be combined')
     process.exit(1)
   }
   const hotMode = hotFlag ? true : noHmrFlag ? false : requestedDriverId !== 'playwright'
@@ -1589,7 +1587,7 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
   // shell last persisted, which silently skews browser comparisons.
   const deviceArg = args.find((_, i) => args[i - 1] === '--device')
   if (deviceArg && !(deviceArg in devices)) {
-    console.error(`  rnxsim open: unknown device "${deviceArg}"`)
+    console.error(`  rnx open: unknown device "${deviceArg}"`)
     console.error(`  known devices: ${listSelectableDeviceModels().join(', ')}`)
     process.exit(1)
   }
@@ -1602,9 +1600,7 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
   const viewportArg = args.find((_, i) => args[i - 1] === '--viewport')
   const viewportMatch = viewportArg ? /^(\d+)x(\d+)$/.exec(viewportArg) : null
   if (viewportArg && !viewportMatch) {
-    console.error(
-      `  rnxsim open: --viewport must be <width>x<height>, got "${viewportArg}"`,
-    )
+    console.error(`  rnx open: --viewport must be <width>x<height>, got "${viewportArg}"`)
     process.exit(1)
   }
   const explicitViewport = viewportMatch
@@ -1719,9 +1715,9 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
           `  open failed: ${err instanceof Error ? err.message : String(err)}`,
         )
         await printBridgeFailureDiagnostics(bridge, {
-          errorsCommand: `rnxsim get errors 5${simHint}`,
-          warningsCommand: `rnxsim get warnings 5${simHint}`,
-          requestsCommand: `rnxsim get requests 5${simHint}`,
+          errorsCommand: `rnx get errors 5${simHint}`,
+          warningsCommand: `rnx get warnings 5${simHint}`,
+          requestsCommand: `rnx get requests 5${simHint}`,
         })
         process.exit(1)
       }
@@ -1774,7 +1770,7 @@ export async function runOpenCommand(args: string[], opts: ControlCommandOptions
 
   const driver = getDriver(driverId)
   if (!driver) {
-    console.error(`  unknown driver "${driverId}" — run \`rnxsim list --drivers\``)
+    console.error(`  unknown driver "${driverId}" — run \`rnx list --drivers\``)
     process.exit(1)
   }
   const connectWait = resolveDriverConnectWaitOptions()
@@ -1860,7 +1856,7 @@ async function runUseLikeCommand(args: string[], opts: ControlCommandOptions = {
           console.error(
             `  refused: ${target.id} is locked by the active user (${secs}s) — that's a live human tab`,
           )
-          console.error(`  run \`rnxsim open --new\` for a fresh investigation sim`)
+          console.error(`  run \`rnx open --new\` for a fresh investigation sim`)
           process.exit(1)
         }
         if (!force) {
@@ -1871,7 +1867,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 \`rnxsim open --new\` for a fresh sim`,
+            `  \`sootsim use ${target.id} --force\` to take it, or \`rnx open --new\` for a fresh sim`,
           )
           process.exit(1)
         }
@@ -1882,9 +1878,9 @@ async function runUseLikeCommand(args: string[], opts: ControlCommandOptions = {
     } catch (err) {
       console.error(`  use failed: ${err instanceof Error ? err.message : String(err)}`)
       await printBridgeFailureDiagnostics(bridge, {
-        errorsCommand: `rnxsim get errors 5${simHint}`,
-        warningsCommand: `rnxsim get warnings 5${simHint}`,
-        requestsCommand: `rnxsim get requests 5${simHint}`,
+        errorsCommand: `rnx get errors 5${simHint}`,
+        warningsCommand: `rnx get warnings 5${simHint}`,
+        requestsCommand: `rnx get requests 5${simHint}`,
       })
       process.exit(1)
     }
@@ -1930,9 +1926,7 @@ export async function runClaimCommand(args: string[], opts: ControlCommandOption
       if (err instanceof BridgeSimLockedError) {
         const secs = Math.max(0, Math.round(err.lock.expiresInMs / 1000))
         console.error(`  claim failed: locked by ${err.lock.by} for ${secs}s more`)
-        console.error(
-          `  use --force to take it, or \`rnxsim open --new\` for a fresh sim`,
-        )
+        console.error(`  use --force to take it, or \`rnx open --new\` for a fresh sim`)
         process.exit(1)
       }
       console.error(`  claim failed: ${err instanceof Error ? err.message : String(err)}`)
@@ -2147,9 +2141,9 @@ export async function runCloseCommand(args: string[], opts: ControlCommandOption
     } catch (err) {
       console.error(`  close failed: ${err instanceof Error ? err.message : String(err)}`)
       await printBridgeFailureDiagnostics(bridge, {
-        errorsCommand: `rnxsim get errors 5${simHint}`,
-        warningsCommand: `rnxsim get warnings 5${simHint}`,
-        requestsCommand: `rnxsim get requests 5${simHint}`,
+        errorsCommand: `rnx get errors 5${simHint}`,
+        warningsCommand: `rnx get warnings 5${simHint}`,
+        requestsCommand: `rnx get requests 5${simHint}`,
       })
       process.exit(1)
     }

package/cli/commands/cpu-profile.ts

@@ -214,9 +214,9 @@ function printNoCdp(cdpPort: number) {
   console.error('  so you can scroll/navigate while profiling):')
   console.error('')
   console.error(
-    `    rnxsim open <metro-port> --new --driver playwright --cdp-port ${cdpPort}`,
+    `    rnx open <metro-port> --new --driver playwright --cdp-port ${cdpPort}`,
   )
-  console.error(`    rnxsim perf cpu --cdp-port ${cdpPort} --match <metro-port>`)
+  console.error(`    rnx perf cpu --cdp-port ${cdpPort} --match <metro-port>`)
   console.error('')
   console.error('  or launch a standalone CDP Chrome (not bridge-driveable):')
   console.error('')

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

@@ -142,8 +142,8 @@ function renderLauncherScript(
   const stdout = shellSingleQuote(logDir.stdout)
   const stderr = shellSingleQuote(logDir.stderr)
   return `#!/bin/sh
-# SootSim Daemon launcher — auto-generated by 'rnxsim setup'.
-# launchd spawns this; we exec the real rnxsim invocation in place so
+# SootSim Daemon launcher — auto-generated by 'rnx setup'.
+# launchd spawns this; we exec the real rnx invocation in place so
 # launchd tracks the daemon process, not the shell wrapper.
 #
 # stdout: ${logDir.stdout}

package/cli/commands/daemon.ts

@@ -329,7 +329,7 @@ export async function daemonInstall({ port, force }: { port: number; force: bool
     const path = macPlistPath()
     if (existsSync(path) && !force) {
       console.log(`  already installed at ${path}`)
-      console.log(`  pass --force to overwrite, or use 'rnxsim daemon restart' to reload`)
+      console.log(`  pass --force to overwrite, or use 'rnx daemon restart' to reload`)
       return
     }
     mkdirSync(dirname(path), { recursive: true })
@@ -379,7 +379,7 @@ export async function daemonInstall({ port, force }: { port: number; force: bool
         throw new Error(
           `launchctl bootstrap failed: ${attempt.reason}` +
             (first !== attempt.reason ? ` (initial: ${first})` : '') +
-            ` — try \`rnxsim daemon uninstall\` then retry, or reboot if launchd state is stuck.`,
+            ` — try \`rnx daemon uninstall\` then retry, or reboot if launchd state is stuck.`,
         )
       }
     }
@@ -420,7 +420,7 @@ export async function daemonInstall({ port, force }: { port: number; force: bool
     const path = linuxUnitPath()
     if (existsSync(path) && !force) {
       console.log(`  already installed at ${path}`)
-      console.log(`  pass --force to overwrite, or use 'rnxsim daemon restart' to reload`)
+      console.log(`  pass --force to overwrite, or use 'rnx daemon restart' to reload`)
       return
     }
     mkdirSync(dirname(path), { recursive: true })
@@ -444,7 +444,7 @@ export async function daemonInstall({ port, force }: { port: number; force: bool
       const msg = (enable.stderr || enable.stdout || '').trim()
       throw new Error(
         `systemctl enable --now failed${msg ? `: ${msg}` : ''}` +
-          ` — try \`rnxsim daemon uninstall\` then retry.`,
+          ` — try \`rnx daemon uninstall\` then retry.`,
       )
     }
     const isActive = spawnSync('systemctl', ['--user', 'is-active', SERVICE_NAME_LINUX], {
@@ -492,7 +492,7 @@ export async function daemonInstall({ port, force }: { port: number; force: bool
   }
 
   console.error(`  background daemon is not supported on ${process.platform}`)
-  console.error(`  run 'rnxsim serve' in a persistent shell instead`)
+  console.error(`  run 'rnx serve' in a persistent shell instead`)
   process.exit(1)
 }
 
@@ -629,8 +629,8 @@ function printBridgeLiveness() {
   }
   console.log(
     lock
-      ? '  bridge:    NOT responding — stale lockfile; check `rnxsim daemon logs`'
-      : '  bridge:    NOT responding — no lockfile; check `rnxsim daemon logs`',
+      ? '  bridge:    NOT responding — stale lockfile; check `rnx daemon logs`'
+      : '  bridge:    NOT responding — no lockfile; check `rnx daemon logs`',
   )
 }
 
@@ -681,7 +681,7 @@ async function daemonRestart() {
   if (process.platform === 'darwin') {
     const path = macPlistPath()
     if (!existsSync(path)) {
-      console.error('  daemon not registered — run `rnxsim setup`')
+      console.error('  daemon not registered — run `rnx setup`')
       process.exit(1)
     }
     const res = spawnSync(
@@ -699,7 +699,7 @@ async function daemonRestart() {
   if (process.platform === 'linux') {
     const path = linuxUnitPath()
     if (!existsSync(path)) {
-      console.error('  daemon not registered — run `rnxsim setup`')
+      console.error('  daemon not registered — run `rnx setup`')
       process.exit(1)
     }
     const res = spawnSync('systemctl', ['--user', 'restart', SERVICE_NAME_LINUX], {
@@ -721,7 +721,7 @@ async function daemonStart() {
   if (process.platform === 'darwin') {
     const path = macPlistPath()
     if (!existsSync(path)) {
-      console.error('  daemon not registered — run `rnxsim setup`')
+      console.error('  daemon not registered — run `rnx setup`')
       process.exit(1)
     }
     const res = spawnSync(
@@ -739,7 +739,7 @@ async function daemonStart() {
   if (process.platform === 'linux') {
     const path = linuxUnitPath()
     if (!existsSync(path)) {
-      console.error('  daemon not registered — run `rnxsim setup`')
+      console.error('  daemon not registered — run `rnx setup`')
       process.exit(1)
     }
     const res = spawnSync('systemctl', ['--user', 'start', SERVICE_NAME_LINUX], {
@@ -814,7 +814,7 @@ async function daemonLogs(rest: string[]) {
     const present = [out, err].filter((p) => existsSync(p))
     if (present.length === 0) {
       console.error(
-        `  no daemon logs yet at ${LOG_DIR} — run \`rnxsim setup\` to install the daemon`,
+        `  no daemon logs yet at ${LOG_DIR} — run \`rnx setup\` to install the daemon`,
       )
       process.exit(1)
     }

package/cli/commands/debug.ts

@@ -57,10 +57,10 @@ const SHELL_TRACE_HOOK_GLOBAL = '__sootsimDebugAnimation'
 
 function printHelp() {
   console.log(`
-rnxsim debug — drive __sootsimDebug from the terminal
+rnx debug — drive __sootsimDebug from the terminal
 
 usage:
-  rnxsim debug <subcommand> [args]
+  rnx debug <subcommand> [args]
 
 subcommands:
   enable <channels>       turn on one or more debug channels
@@ -122,16 +122,16 @@ options:
   --json                  compact JSON output for pipelines
 
 examples:
-  rnxsim debug enable sheets,portals
-  rnxsim debug snapshot before
-  rnxsim debug snapshot after
-  rnxsim debug diff before after
-  rnxsim debug image-audit          per-image source pixels per device pixel
-  rnxsim debug find sheets | jq '.[] | select(.translateY != null)'
-  rnxsim debug trace shell on 240
-  rnxsim debug trace shell 120
-  rnxsim debug trace anim on 3 240
-  rnxsim debug trace anim 3 60
+  rnx debug enable sheets,portals
+  rnx debug snapshot before
+  rnx debug snapshot after
+  rnx debug diff before after
+  rnx debug image-audit          per-image source pixels per device pixel
+  rnx debug find sheets | jq '.[] | select(.translateY != null)'
+  rnx debug trace shell on 240
+  rnx debug trace shell 120
+  rnx debug trace anim on 3 240
+  rnx debug trace anim 3 60
 `)
 }
 
@@ -436,7 +436,7 @@ export async function runDebug(args: string[], opts: DebugOptions) {
         const channels = parseChannelList(rest[0])
         if (channels.length === 0) {
           console.error(
-            `  usage: rnxsim debug enable <channel[,channel,...]>\n  known: ${KNOWN_CHANNELS.join(', ')}`,
+            `  usage: rnx debug enable <channel[,channel,...]>\n  known: ${KNOWN_CHANNELS.join(', ')}`,
           )
           process.exit(1)
         }
@@ -455,7 +455,7 @@ export async function runDebug(args: string[], opts: DebugOptions) {
       case 'toggle': {
         const channel = rest[0]
         if (!channel) {
-          console.error('  usage: rnxsim debug toggle <channel>')
+          console.error('  usage: rnx debug toggle <channel>')
           process.exit(1)
         }
         const result = await call(
@@ -515,7 +515,7 @@ export async function runDebug(args: string[], opts: DebugOptions) {
         const a = rest[0]
         const b = rest[1]
         if (!a || !b) {
-          console.error('  usage: rnxsim debug diff <labelA> <labelB>')
+          console.error('  usage: rnx debug diff <labelA> <labelB>')
           process.exit(1)
         }
         // Maps don't serialize — project added/removed/changed arrays only
@@ -577,7 +577,7 @@ export async function runDebug(args: string[], opts: DebugOptions) {
           const result = await inspectDebugFind(bridge, target)
           console.log(fmt(result, pretty))
         } else {
-          console.error('  usage: rnxsim debug find <sheets|portals|boundaries>')
+          console.error('  usage: rnx debug find <sheets|portals|boundaries>')
           process.exit(1)
         }
         break
@@ -594,7 +594,7 @@ export async function runDebug(args: string[], opts: DebugOptions) {
           const sub = rest[1]
           if (!sub || sub === '--help' || sub === '-h') {
             console.error(
-              '  usage: rnxsim debug trace anim <on|off|status|clear|<id>> [id|limit]',
+              '  usage: rnx debug trace anim <on|off|status|clear|<id>> [id|limit]',
             )
             process.exit(1)
           }
@@ -641,7 +641,7 @@ export async function runDebug(args: string[], opts: DebugOptions) {
           break
         }
         if (traceTarget !== 'shell') {
-          console.error('  usage: rnxsim debug trace <shell|anim> [args]')
+          console.error('  usage: rnx debug trace <shell|anim> [args]')
           process.exit(1)
         }
         if (!traceCommand || /^[0-9]+$/.test(traceCommand)) {
@@ -672,7 +672,7 @@ export async function runDebug(args: string[], opts: DebugOptions) {
           break
         }
         console.error(
-          '  usage: rnxsim debug trace shell [on [limit]|off|status|clear|recentLimit]',
+          '  usage: rnx debug trace shell [on [limit]|off|status|clear|recentLimit]',
         )
         process.exit(1)
       }
@@ -707,9 +707,9 @@ export async function runDebug(args: string[], opts: DebugOptions) {
   } catch (err: any) {
     console.error(`  debug failed: ${err.message}`)
     await printBridgeFailureDiagnostics(bridge, {
-      errorsCommand: `rnxsim get errors 5${simHint}`,
-      warningsCommand: `rnxsim get warnings 5${simHint}`,
-      requestsCommand: `rnxsim get requests 5${simHint}`,
+      errorsCommand: `rnx get errors 5${simHint}`,
+      warningsCommand: `rnx get warnings 5${simHint}`,
+      requestsCommand: `rnx get requests 5${simHint}`,
     })
     process.exit(1)
   } finally {

package/cli/commands/desktop.ts

@@ -8,11 +8,11 @@ interface DesktopOptions {
 
 function printHelp(): void {
   console.log(`
-rnxsim desktop — launch or install the desktop companion
+rnx desktop — launch or install the desktop companion
 
 usage:
-  rnxsim desktop [options]
-  rnxsim desktop install [options]
+  rnx desktop [options]
+  rnx desktop install [options]
 
 options:
   --port <number>     connect to a running dev server on this port