rnxsim 0.1.335 → 0.1.336

package/cli/commands/detox.ts

@@ -38,18 +38,18 @@ interface RunDetoxOpts {
 }
 
 const HELP = `
-rnxsim detox — run detox-style tests against an rnx shell
+rnx detox — run detox-style tests against an rnx shell
 
 usage:
-  rnxsim detox [testFiles...]        run all tests under e2e/, test/e2e/, or detox/
-  rnxsim detox --config <path>       use a specific jest config
-  rnxsim detox init                  scaffold sootsim-detox.config.cjs + sample test
-  rnxsim detox --watch               jest watch mode
-  rnxsim detox --headed              keep the rnx shell window visible
-  rnxsim detox -t <pattern>          pass a jest --testNamePattern
-  rnxsim detox --no-launch           skip auto-launching an rnx shell
-
-rnxsim detox auto-launches an rnx shell if none is running on the
+  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 --watch               jest watch mode
+  rnx detox --headed              keep the rnx shell window visible
+  rnx detox -t <pattern>          pass a jest --testNamePattern
+  rnx detox --no-launch           skip auto-launching an rnx shell
+
+rnx detox auto-launches an rnx shell if none is running on the
 expected port. disable with --no-launch if you're managing the shell yourself.
 `
 
@@ -122,7 +122,7 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
   if (!testDir) {
     console.error(
       `  error: no detox tests found. expected one of: ${detoxDirs.join(', ')}\n` +
-        `  run 'rnxsim detox init' to scaffold a starter suite.`,
+        `  run 'rnx detox init' to scaffold a starter suite.`,
     )
     process.exit(1)
   }
@@ -190,7 +190,7 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
   // any positional test files get passed straight through
   jestArgs.push(...positional)
 
-  console.log(`  rnxsim detox`)
+  console.log(`  rnx detox`)
   console.log(`    test dir: ${testDir}`)
   console.log(`    port:     ${port}${headed ? ' (headed)' : ''}`)
   if (localConfig) console.log(`    config:   ${localConfig}`)
@@ -330,7 +330,7 @@ async function ensureShellRunning(port: number): Promise<void> {
   if (shellUrl) return
 
   console.warn(
-    `  warn: no rnx shell reachable on :${port}. start your app, then run \`rnxsim open <app-port>\`\n` +
+    `  warn: no rnx shell reachable on :${port}. start your app, then run \`rnx open <app-port>\`\n` +
       `  or pass --no-launch if you're managing the shell yourself.`,
   )
 }
@@ -343,7 +343,7 @@ function initDetoxProject(): void {
   } else {
     writeFileSync(
       configPath,
-      `// rnxsim detox jest config.
+      `// rnx detox jest config.
 // extends the sootsim preset, which rewrites \`import ... from 'detox'\`
 // to the sootsim driver and keeps your jest transforms intact.
 
@@ -366,7 +366,7 @@ module.exports = {
     mkdirSync(e2eDir, { recursive: true })
     writeFileSync(
       samplePath,
-      `// sample rnxsim detox test. resolve \`detox\` via the jest preset in
+      `// sample rnx detox test. resolve \`detox\` via the jest preset in
 // sootsim-detox.config.cjs — no extra imports required.
 
 import { by, device, element, expect, waitFor } from 'detox'
@@ -391,7 +391,7 @@ describe('example', () => {
   }
 
   console.log(`\n  next:`)
-  console.log(`    rnxsim detox        # run the sample`)
-  console.log(`    rnxsim detox --watch`)
+  console.log(`    rnx detox        # run the sample`)
+  console.log(`    rnx detox --watch`)
   process.exit(0)
 }

package/cli/commands/device.ts

@@ -25,18 +25,18 @@ type CurrentDeviceSnapshot = {
 
 function usage() {
   console.log(`
-rnxsim device — inspect or change the live device preset for a sim
+rnx device — inspect or change the live device preset for a sim
 
 usage:
-  rnxsim device
-  rnxsim device get
-  rnxsim device set <model> [--sim <id>]
-  rnxsim device list
+  rnx device
+  rnx device get
+  rnx device set <model> [--sim <id>]
+  rnx device list
 
 examples:
-  rnxsim device
-  rnxsim device set iphone-14
-  rnxsim device set iphone-16-pro-max --sim a7
+  rnx device
+  rnx device set iphone-14
+  rnx device set iphone-16-pro-max --sim a7
 `)
 }
 
@@ -105,7 +105,7 @@ export async function runDeviceCommand(args: string[], opts: DeviceCommandOption
     }
     if (!(model in devices)) {
       console.error(`  error: unknown device "${model}"`)
-      console.error('  run `rnxsim device list` to see valid models')
+      console.error('  run `rnx device list` to see valid models')
       process.exit(1)
     }
     const parsed = parseBridgeCliArgs(args, { port: opts.port })

package/cli/commands/diagnose.ts

@@ -101,10 +101,10 @@ const DEFAULT_INCLUDES = new Set(['timeline', 'network', 'react', 'console', 'sc
 
 function printHelp(): void {
   console.log(`
-rnxsim get diagnosis — compact "what just went wrong?" report
+rnx get diagnosis — compact "what just went wrong?" report
 
 usage:
-  rnxsim get diagnosis [--since <duration>] [--include <csv>] [--json]
+  rnx get diagnosis [--since <duration>] [--include <csv>] [--json]
 
 options:
   --since <d>           absolute window for timeline + network (e.g. 90s, 2m, 500ms; default 90s)
@@ -115,14 +115,14 @@ options:
   --json                emit a single structured JSON document
 
 the diagnose report runs every dimension in parallel against the same
-sim and returns a grouped summary. use \`rnxsim what-happened\`
-for chronological events, \`rnxsim network\` for full request inspection,
-\`rnxsim perf react summary\` for the React tables on their own.
+sim and returns a grouped summary. use \`rnx what-happened\`
+for chronological events, \`rnx network\` for full request inspection,
+\`rnx perf react summary\` for the React tables on their own.
 
 examples:
-  rnxsim get diagnosis
-  rnxsim get diagnosis --since 30s --include network,react
-  rnxsim get diagnosis --json > /tmp/diagnosis.json
+  rnx get diagnosis
+  rnx get diagnosis --since 30s --include network,react
+  rnx get diagnosis --json > /tmp/diagnosis.json
 `)
 }
 
@@ -371,7 +371,7 @@ export async function runDiagnose(
   const sub = parsed.positional[0] ?? 'recent'
   if (sub !== 'recent') {
     console.error(`  unknown subcommand: ${sub}`)
-    console.error('  did you mean: rnxsim get diagnosis ?')
+    console.error('  did you mean: rnx get diagnosis ?')
     return 1
   }
 
@@ -567,7 +567,7 @@ export async function runDiagnose(
     const identityKey = getCliIdentityKey()
     if (identityKey) {
       console.log(
-        `\n  next: rnxsim what-happened (cursor advances) · rnxsim network get <id> · rnxsim perf react why <fiber-id>`,
+        `\n  next: rnx what-happened (cursor advances) · rnx network get <id> · rnx perf react why <fiber-id>`,
       )
     }
     return 0
@@ -578,7 +578,7 @@ export async function runDiagnose(
     // exit non-zero so `sootsim 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: rnxsim open <metroPort>')
+      console.error('  no sim connected — open one first: rnx open <metroPort>')
     } else {
       console.error(`  diagnose failed: ${msg}`)
     }

package/cli/commands/electron.ts

@@ -38,10 +38,10 @@ export async function resolveElectronLaunchUrl(
 export async function runElectron(args: string[], opts: ElectronOptions) {
   if (args.includes('--help') || args.includes('-h')) {
     console.log(`
-rnxsim desktop — launch the desktop companion
+rnx desktop — launch the desktop companion
 
 usage:
-  rnxsim desktop [options]
+  rnx desktop [options]
 
 options:
   --port <number>     connect to running dev server on this port
@@ -49,9 +49,9 @@ options:
   --ephemeral         launch with a temporary isolated storage profile
 
 examples:
-  rnxsim desktop
-  rnxsim desktop --port 5173
-  rnxsim desktop --profile qa
+  rnx desktop
+  rnx desktop --port 5173
+  rnx desktop --profile qa
 `)
     process.exit(0)
   }
@@ -59,7 +59,7 @@ examples:
   const profileArg = args.find((_, i) => args[i - 1] === '--profile')
   const ephemeralProfile = args.includes('--ephemeral')
   if (profileArg && ephemeralProfile) {
-    console.error('  rnxsim desktop: --profile cannot be combined with --ephemeral')
+    console.error('  rnx desktop: --profile cannot be combined with --ephemeral')
     process.exit(1)
   }
   const profileId = profileArg ? ensureProfile(profileArg).id : undefined
@@ -70,7 +70,7 @@ examples:
       process.stdin.isTTY &&
       process.env.CI !== '1' &&
       process.env.SOOTSIM_NO_PROMPT !== '1'
-    if (canPrompt && (await confirm('run rnxsim desktop install now?', true))) {
+    if (canPrompt && (await confirm('run rnx desktop install now?', true))) {
       console.log()
       const { runInstallDesktop } = await import('./install-desktop')
       await runInstallDesktop(['--yes'])

package/cli/commands/film.ts

@@ -68,10 +68,10 @@ async function evalInPage<T>(bridge: WsBridge, code: string, timeoutMs = 30_000)
 export async function runFilm(args: string[], opts: FilmOptions): Promise<number> {
   if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
     console.log(`
-rnxsim film — record a flow flat, replay it on the 3d stage, save a clip
+rnx film — record a flow flat, replay it on the 3d stage, save a clip
 
 usage:
-  rnxsim film <flow.yaml> [options]
+  rnx film <flow.yaml> [options]
 
 how it works:
   1. the flow runs at full speed on the flat canvas while the engine
@@ -90,16 +90,16 @@ options:
   --keep-three           leave 3d mode + the recording editor on afterwards
   --sim <id>             target a specific connected sim
 
-stage decor (same flags as \`rnxsim mode three configure\`):
+stage decor (same flags as \`rnx mode three configure\`):
   --background <id> · --gradient <stops> · --gradient-angle <deg>
   --colorway <id> · --room on|off · --focus on|off · --focus-amount <id>
   --focus-range <id> · --environment on|off · --env-shape/spread/size/color
   --env-glow on|off · --env-plastic on|off
 
 examples:
-  rnxsim film flows/feed-scroll.yaml
-  rnxsim film flows/swap.yaml --script hero-arc --background gradient-tide --out ~/Desktop/swap-3d.mp4
-  rnxsim film flows/login.yaml --colorway deep-blue --environment on --env-shape pane --room on
+  rnx film flows/feed-scroll.yaml
+  rnx film flows/swap.yaml --script hero-arc --background gradient-tide --out ~/Desktop/swap-3d.mp4
+  rnx film flows/login.yaml --colorway deep-blue --environment on --env-shape pane --room on
 `)
     return 0
   }

package/cli/commands/inspect/core.ts

@@ -1102,17 +1102,16 @@ export function scoreInteractive(n: InteractiveNode): number {
   return score
 }
 
-// the copy-paste `sootsim do` tap command for an interactive node.
+// the copy-paste `rnx do` tap command for an interactive node.
 export function tapCommandForNode(n: InteractiveNode): string {
-  if (n.testID) return `rnxsim do tap-id ${shellEscape(n.testID)}`
+  if (n.testID) return `rnx do tap-id ${shellEscape(n.testID)}`
   const text = typeof n.text === 'string' ? n.text.trim() : ''
-  if (text.length > 0 && text.length <= 80)
-    return `rnxsim do tap-text ${shellEscape(text)}`
+  if (text.length > 0 && text.length <= 80) return `rnx do tap-text ${shellEscape(text)}`
   const x =
     Math.round(((n.absolutePosition?.x ?? 0) + (n.layout?.width ?? 0) / 2) * 10) / 10
   const y =
     Math.round(((n.absolutePosition?.y ?? 0) + (n.layout?.height ?? 0) / 2) * 10) / 10
-  return `rnxsim do tap ${x} ${y}`
+  return `rnx do tap ${x} ${y}`
 }
 
 function shellEscape(value: string): string {
@@ -1154,7 +1153,7 @@ export const WAIT_READY_PROBE = `(async () => {
     const loadingSignal = (value) => {
       const text = cleanText(value)
       if (!text) return ''
-      return /^(opening app\\b|looking for your app\\b|building bundle\\b|preparing rnxsim runtime\\b|loading native bundle\\b|loading rnx stubs\\b|loading bundle loader\\b|loading native stubs\\b|loading compat bridge\\b|loading react-native shim\\b|loading react bridge\\b|loading reconciler\\b|loading replacement modules\\b|injecting rnx modules\\b|warming sqlite engine\\b|capturing root component\\b|reloading app\\b|loading(?:[.!…]*)?$|connecting(?:[.!…]*)?$)/i.test(text)
+      return /^(opening app\\b|looking for your app\\b|building bundle\\b|preparing rnx runtime\\b|loading native bundle\\b|loading rnx stubs\\b|loading bundle loader\\b|loading native stubs\\b|loading compat bridge\\b|loading react-native shim\\b|loading react bridge\\b|loading reconciler\\b|loading replacement modules\\b|injecting rnx modules\\b|warming sqlite engine\\b|capturing root component\\b|reloading app\\b|loading(?:[.!…]*)?$|connecting(?:[.!…]*)?$)/i.test(text)
         ? text
         : ''
     }
@@ -1342,7 +1341,7 @@ export function waitReadyReason(
   > & { bridgeError?: string },
 ): string {
   if (status.bridgeError) {
-    return `sim unreachable: ${status.bridgeError} — the target tab is closed or no sim is connected (check \`rnxsim list\`, reopen with \`rnxsim open\`)`
+    return `sim unreachable: ${status.bridgeError} — the target tab is closed or no sim is connected (check \`rnx list\`, reopen with \`rnx open\`)`
   }
   const base = status.externalError
     ? `guest app errored: ${status.externalError}`

package/cli/commands/inspect/find.ts

@@ -31,7 +31,7 @@ export async function runFindSubcommand(opts: {
   // ranked-tappable list — same data source as --pressable, but the
   // output prioritises high-signal targets the agent likely wants to
   // tap next (visible, has text or testID, has accessibilityLabel),
-  // and emits a copy-paste `sootsim do` command per row so the agent
+  // and emits a copy-paste `rnx do` command per row so the agent
   // doesn't have to re-form a tap from raw fields.
   const interactive = hasFlag('--interactive-targets') || hasFlag('--actions')
   const bareText =
@@ -69,7 +69,7 @@ export async function runFindSubcommand(opts: {
   if (jsonOut) {
     if (mode === 'interactive-targets' && Array.isArray(result)) {
       // include the `tap` command per row when emitting JSON for agents
-      // — the human renderer does the same. tooling that drives sootsim
+      // — the human renderer does the same. tooling that drives rnx
       // can pick the highest-scored entry and execute its `tap` field.
       printJson(rankInteractive(result).map((n) => ({ ...n, tap: tapCommandForNode(n) })))
     } else {

package/cli/commands/inspect.ts

@@ -151,8 +151,8 @@ function formatNetworkDuration(ms: number | null): string {
 function printRecoverHint(): void {
   process.stderr.write(
     `  the sim is not responding. recover it with:\n` +
-      `    rnxsim close --sim <id>   # force-close the wedged sim\n` +
-      `    rnxsim list               # confirm it's gone\n`,
+      `    rnx close --sim <id>   # force-close the wedged sim\n` +
+      `    rnx list               # confirm it's gone\n`,
   )
 }
 
@@ -831,7 +831,7 @@ async function requireVisualKeyboard(bridge: WsBridge, actionLabel: string) {
     process.exit(1)
   }
   console.error(
-    `  ${actionLabel} requires the iOS keyboard to be visible. focus an input first with rnxsim do tap-id/tap-text or rnxsim do type-into.`,
+    `  ${actionLabel} requires the iOS keyboard to be visible. focus an input first with rnx do tap-id/tap-text or rnx do type-into.`,
   )
   process.exit(1)
 }
@@ -903,9 +903,9 @@ function keyCodeToVisualKey(code: string) {
 }
 
 function getInspectCommandName(subcommand: string, directSubcommand: string | null) {
-  if (directSubcommand === subcommand) return `rnxsim ${subcommand}`
+  if (directSubcommand === subcommand) return `rnx ${subcommand}`
   const group = getCliInspectVerbMeta(subcommand)?.group
-  return group ? `rnxsim ${group} ${subcommand}` : `rnxsim ${subcommand}`
+  return group ? `rnx ${group} ${subcommand}` : `rnx ${subcommand}`
 }
 
 function getInspectUsage(
@@ -956,7 +956,7 @@ async function recordInspectAction(
         '`maestro keep` commits one action at a time',
     )
   } else {
-    console.error('  draft: action pending — `rnxsim maestro keep` to commit')
+    console.error('  draft: action pending — `rnx maestro keep` to commit')
   }
 }
 
@@ -1099,14 +1099,14 @@ export async function runInspect(args: string[], opts: InspectOptions) {
   const topLevelCommand = isTopLevel ? effectiveArgs[0] : null
   // a usage string has to name something the user can actually type. the
   // registry knows which group each verb belongs to, so an unprefixed
-  // invocation still renders `rnxsim get tree` rather than a bare verb.
+  // invocation still renders `rnx get tree` rather than a bare verb.
   const inspectCommand = (name: string) => {
     if (opts.internalPerfCommand && name === 'perf') {
-      return `rnxsim perf ${opts.internalPerfCommand}`
+      return `rnx perf ${opts.internalPerfCommand}`
     }
-    if (isTopLevel && name === effectiveArgs[0]) return `rnxsim ${name}`
+    if (isTopLevel && name === effectiveArgs[0]) return `rnx ${name}`
     const group = invocationPrefix ?? getCliInspectVerbMeta(name)?.group
-    return group ? `rnxsim ${group} ${name}` : `rnxsim ${name}`
+    return group ? `rnx ${group} ${name}` : `rnx ${name}`
   }
   const inspectUsage = (name: string, tail: string) =>
     `  usage: ${inspectCommand(name)}${tail ? ` ${tail}` : ''}`
@@ -1289,7 +1289,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       })
       if (!settled) {
         process.stderr.write(
-          `  ⚠ auto-wait timed out after ${elapsed ?? budgetMs}ms — next command may see mid-animation state. use \`rnxsim do settle\` for a longer wait.\n`,
+          `  ⚠ auto-wait timed out after ${elapsed ?? budgetMs}ms — next command may see mid-animation state. use \`rnx do settle\` for a longer wait.\n`,
         )
       }
     } catch {
@@ -1304,7 +1304,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         `  tap failed: ${label} resolved to (${Math.round(x)},${Math.round(y)}), outside the ${screen?.width}x${screen?.height} screen`,
       )
       console.error(
-        '  the node exists but is scrolled out of view — scroll it on-screen first (rnxsim do scroll / swipe), then tap.',
+        '  the node exists but is scrolled out of view — scroll it on-screen first (rnx do scroll / swipe), then tap.',
       )
       return
     }
@@ -1527,7 +1527,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       if (!seen.has(kind) && n) parts.push(`${n} ${kind}${n === 1 ? '' : 's'}`)
     }
     if (parts.length === 0) return
-    console.error(`\n  since last: ${parts.join(' · ')} — rnxsim what-happened`)
+    console.error(`\n  since last: ${parts.join(' · ')} — rnx what-happened`)
     // advance cursor so the next CLI call only sees *new* events.
     if (payload.summary.lastAt) {
       try {
@@ -1593,7 +1593,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
   const verboseTransitions =
     (args.includes('--verbose') || args.includes('-v')) && !args.includes('--json')
   if (invocationPrefix === 'do' && subcommand === 'shell') {
-    console.error('  `rnxsim do shell` was removed. use `rnxsim shell ...` instead.')
+    console.error('  `rnx do shell` was removed. use `rnx shell ...` instead.')
     process.exit(1)
   }
   if (writeCommands.has(subcommand)) {
@@ -2150,7 +2150,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const payload = outcome.payload
 
         if (payload?.error === 'bridge-not-ready') {
-          console.error('  rnxsim test bridge not ready')
+          console.error('  rnx test bridge not ready')
           process.exit(1)
         }
 
@@ -2297,7 +2297,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           | null
         if (!payload) {
           console.error(
-            `  tap-best: no testID or visible text matched "${query}". try \`rnxsim find --interactive-targets\` to list candidates.`,
+            `  tap-best: no testID or visible text matched "${query}". try \`rnx find --interactive-targets\` to list candidates.`,
           )
           process.exit(1)
         }
@@ -2307,7 +2307,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         }
         if (payload.strategy === 'none') {
           console.error(
-            `  tap-best: no testID or visible text matched "${query}". try \`rnxsim find --interactive-targets\` to list candidates.`,
+            `  tap-best: no testID or visible text matched "${query}". try \`rnx find --interactive-targets\` to list candidates.`,
           )
           process.exit(1)
         }
@@ -3646,24 +3646,24 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const lc = code.toLowerCase()
         const suggestions: string[] = []
         if (lc.includes('sootsim:gohome') || lc.includes('gohome'))
-          suggestions.push('rnxsim shell home')
+          suggestions.push('rnx shell home')
         if (lc.includes('sootsim:appswitcher') || lc.includes('appswitcher'))
-          suggestions.push('rnxsim shell switcher')
+          suggestions.push('rnx shell switcher')
         if (lc.includes('keyboard.isvisible') || lc.includes('keyboard.getmode'))
-          suggestions.push('rnxsim debug state keyboard')
-        if (lc.includes('interact.tap')) suggestions.push('rnxsim do tap <x> <y>')
-        if (lc.includes('keyboard.type')) suggestions.push('rnxsim do type <text>')
+          suggestions.push('rnx debug state keyboard')
+        if (lc.includes('interact.tap')) suggestions.push('rnx do tap <x> <y>')
+        if (lc.includes('keyboard.type')) suggestions.push('rnx do type <text>')
         if (lc.includes('keyboard.press') || lc.includes('keyboard.dispatchkey'))
-          suggestions.push('rnxsim do key <name>')
-        if (lc.includes('keyboard.dismiss')) suggestions.push('rnxsim do dismiss')
-        if (lc.includes('dumptree')) suggestions.push('rnxsim get tree')
-        if (lc.includes('dumpaccessibilitytree')) suggestions.push('rnxsim get a11y')
-        if (lc.includes('getnodecount')) suggestions.push('rnxsim get count')
-        if (lc.includes('findbytext')) suggestions.push('rnxsim find <text>')
+          suggestions.push('rnx do key <name>')
+        if (lc.includes('keyboard.dismiss')) suggestions.push('rnx do dismiss')
+        if (lc.includes('dumptree')) suggestions.push('rnx get tree')
+        if (lc.includes('dumpaccessibilitytree')) suggestions.push('rnx get a11y')
+        if (lc.includes('getnodecount')) suggestions.push('rnx get count')
+        if (lc.includes('findbytext')) suggestions.push('rnx find <text>')
         if (lc.includes('findbytestid') || lc.includes('findbyid'))
-          suggestions.push('rnxsim find --testid <id>')
+          suggestions.push('rnx find --testid <id>')
         if (lc.includes('document.hidden'))
-          suggestions.push('rnxsim debug state keyboard  (includes tab health)')
+          suggestions.push('rnx debug state keyboard  (includes tab health)')
         if (suggestions.length > 0) {
           maybeHint('prefer-cli-over-eval', suggestions)
         }
@@ -3734,7 +3734,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
 
       case 'perf': {
         if (invocationPrefix === 'debug' && !opts.internalPerfCommand) {
-          console.error('  `rnxsim debug perf` was removed. use `rnxsim perf shell ...`.')
+          console.error('  `rnx debug perf` was removed. use `rnx perf shell ...`.')
           process.exit(1)
         }
         const perfCmd = positional[1]
@@ -4221,7 +4221,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         if (sub === 'get') {
           const id = positional[2]
           if (!id) {
-            console.error('  usage: rnxsim network get <id>')
+            console.error('  usage: rnx network get <id>')
             process.exit(1)
           }
           const entry = (await bridge.send({
@@ -4524,7 +4524,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
     }
   } catch (err: any) {
     const message = err instanceof Error ? err.message : String(err)
-    console.error(`  ${subcommand ?? 'rnxsim'} failed: ${message}`)
+    console.error(`  ${subcommand ?? 'rnx'} failed: ${message}`)
     const unknownSim = /^no sim connected with id ([^;]+)(?:; connected sims: .+)?$/.exec(
       message,
     )
@@ -4557,9 +4557,9 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         process.stderr.write(
           `  the sim is still responsive — '${cmd}' just exceeded the ${timedOut[1]}s command budget.\n` +
             `  the screen's node tree is large; narrow the query or raise the budget:\n` +
-            `    rnxsim ${cmd} --testid <id>     # scope to one subtree\n` +
-            `    rnxsim find --testid <id>       # targeted single-node lookup\n` +
-            `    rnxsim ${cmd} --timeout 60000   # raise per-command budget (ms)\n`,
+            `    rnx ${cmd} --testid <id>     # scope to one subtree\n` +
+            `    rnx find --testid <id>       # targeted single-node lookup\n` +
+            `    rnx ${cmd} --timeout 60000   # raise per-command budget (ms)\n`,
         )
       } else {
         printRecoverHint()

package/cli/commands/install-desktop.ts

@@ -223,22 +223,22 @@ async function installWindowsExe(exePath: string): Promise<string> {
 export async function runInstallDesktop(args: string[]) {
   if (args.includes('--help') || args.includes('-h')) {
     console.log(`
-rnxsim desktop install — download and install the optional desktop GUI
+rnx desktop install — download and install the optional desktop GUI
 
 the CLI + daemon are the canonical rnx surface; the GUI is optional.
 if you just want to drive a running metro/expo dev server from the
 terminal, you don't need this.
 
 usage:
-  rnxsim desktop install [options]
+  rnx desktop install [options]
 
 options:
   -y, --yes         skip confirmation and install immediately
   --force           reinstall even if the companion is already present
 
 examples:
-  rnxsim desktop install
-  rnxsim desktop install --yes
+  rnx desktop install
+  rnx desktop install --yes
 `)
     process.exit(0)
   }
@@ -253,7 +253,7 @@ examples:
 
   const existing = findDesktopCompanion()
   if (existing && !force) {
-    console.log(`  rnxsim desktop already installed at: ${existing.path}`)
+    console.log(`  rnx desktop already installed at: ${existing.path}`)
     console.log('  pass --force to reinstall.')
     return
   }
@@ -309,7 +309,7 @@ examples:
     console.error(
       '  network blocked the request. check your connection and try again later;',
     )
-    console.error('  the CLI + daemon work without the desktop app (run: rnxsim --help).')
+    console.error('  the CLI + daemon work without the desktop app (run: rnx --help).')
     process.exit(1)
   }
 
@@ -346,6 +346,6 @@ examples:
 
   console.log()
   console.log('  next steps:')
-  console.log('    rnxsim desktop         launch the desktop app')
-  console.log('    rnxsim open <target>   open a demo or bundle in it')
+  console.log('    rnx desktop         launch the desktop app')
+  console.log('    rnx open <target>   open a demo or bundle in it')
 }

package/cli/commands/login.ts

@@ -29,10 +29,10 @@ async function resolveDefaultAuthOrigin(explicitOrigin?: string) {
 
 function printHelp() {
   console.log(`
-rnxsim login — sign in so uploads can attach to your account
+rnx login — sign in so uploads can attach to your account
 
 usage:
-  rnxsim login [--origin <url>]
+  rnx login [--origin <url>]
 
 options:
   --origin <url>     auth host (default: auto)
@@ -246,7 +246,7 @@ export async function runLogin(args: string[]) {
 
         if (!token) {
           res.end(
-            renderCallbackPage('missing token. close this tab and retry `rnxsim login`.'),
+            renderCallbackPage('missing token. close this tab and retry `rnx login`.'),
           )
           finish({ ok: false, error: 'missing token' })
           return
@@ -256,7 +256,7 @@ export async function runLogin(args: string[]) {
         finish({ ok: true, token, email, userId })
       } catch (err) {
         res.statusCode = 500
-        res.end(renderCallbackPage('sign-in callback failed. retry `rnxsim login`.'))
+        res.end(renderCallbackPage('sign-in callback failed. retry `rnx login`.'))
         finish({
           ok: false,
           error: err instanceof Error ? err.message : 'callback failed',
@@ -268,7 +268,7 @@ export async function runLogin(args: string[]) {
       finish({
         ok: false,
         error:
-          'timed out waiting for the browser sign-in (5 minutes). rerun `rnxsim login` and complete the github authorize screen if it appears.',
+          'timed out waiting for the browser sign-in (5 minutes). rerun `rnx login` and complete the github authorize screen if it appears.',
       })
     }, LOGIN_TIMEOUT_MS)
 
@@ -284,7 +284,7 @@ export async function runLogin(args: string[]) {
       url.searchParams.set('port', String(address.port))
       url.searchParams.set('contrast', origin)
 
-      console.log('  opening browser for rnxsim login...')
+      console.log('  opening browser for rnx login...')
       console.log(
         '  first time here? github will show an authorize screen. approve it to continue.',
       )

package/cli/commands/maestro-generate.ts

@@ -303,13 +303,13 @@ function buildFlowArgs(
 export async function runMaestroGenerate(args: string[]): Promise<number> {
   const promptArg = findPrompt(args)
   if (!promptArg) {
-    console.error('  usage: rnxsim maestro generate "test goal"')
+    console.error('  usage: rnx maestro generate "test goal"')
     return 1
   }
   const { prompt, index: promptIndex } = promptArg
   const cliAuth = resolveCliAuth()
   if (!cliAuth || cliAuth.kind === 'github') {
-    console.error('  rnxsim maestro generate "<goal>" needs a login or RNX_API_KEY.')
+    console.error('  rnx maestro generate "<goal>" needs a login or RNX_API_KEY.')
     console.error('  API keys must include preview_upload and llm scopes.')
     return 1
   }