rnxsim 0.1.335 → 0.1.337

package/cli/commands/maestro.ts

@@ -30,17 +30,17 @@ const MAESTRO_DIRS = ['.maestro', 'maestro']
 
 function printHelp() {
   console.log(`
-rnxsim maestro — author and run Maestro YAML flows against rnx
+rnx maestro — author and run Maestro YAML flows against rnx
 
 usage:
-  rnxsim maestro                         # discover .maestro/ or maestro/ in cwd, run all
-  rnxsim maestro test <flow-or-dir>      # mirrors "maestro test"
-  rnxsim maestro test .maestro/          # every *.yaml / *.yml in a directory
-  rnxsim maestro generate "<goal>"       # generate, run, and upload a Maestro flow
-  rnxsim maestro start|keep|end          # author a flow from live CLI actions
-  rnxsim maestro validate <flow>         # validate a Maestro YAML file
-  rnxsim maestro init                    # scaffold .maestro/login.yaml
-  rnxsim maestro --list-compat           # print supported/unsupported verbs
+  rnx maestro                         # discover .maestro/ or maestro/ in cwd, run all
+  rnx maestro test <flow-or-dir>      # mirrors "maestro test"
+  rnx maestro test .maestro/          # every *.yaml / *.yml in a directory
+  rnx maestro generate "<goal>"       # generate, run, and upload a Maestro flow
+  rnx maestro start|keep|end          # author a flow from live CLI actions
+  rnx maestro validate <flow>         # validate a Maestro YAML file
+  rnx maestro init                    # scaffold .maestro/login.yaml
+  rnx maestro --list-compat           # print supported/unsupported verbs
 
 options:
   --env KEY=VALUE        set env vars for \${KEY} interpolation (repeatable)
@@ -58,19 +58,19 @@ options:
   --slow <ms>            delay between steps for natural pacing
 
 examples:
-  rnxsim maestro test .maestro/login.yaml
-  rnxsim maestro test .maestro/
-  rnxsim maestro generate "log in and verify the welcome screen"
-  rnxsim maestro start
-  rnxsim maestro end --output .maestro/login.yaml --validate
-  rnxsim maestro --env USERNAME=alice test .maestro/login.yaml
-  rnxsim maestro init
+  rnx maestro test .maestro/login.yaml
+  rnx maestro test .maestro/
+  rnx maestro generate "log in and verify the welcome screen"
+  rnx maestro start
+  rnx maestro end --output .maestro/login.yaml --validate
+  rnx maestro --env USERNAME=alice test .maestro/login.yaml
+  rnx maestro init
 `)
 }
 
 function printCompatMatrix() {
   console.log(`
-rnxsim maestro — compatibility matrix
+rnx maestro — compatibility matrix
 
 supported verbs:
   launchApp, stopApp, clearState, clearKeychain (warn-only),
@@ -246,8 +246,8 @@ async function runInit(cwd: string): Promise<number> {
     console.error(`  error: ${outPath} already exists`)
     return 1
   }
-  const starter = `# rnxsim maestro starter flow — drop-in compatible with the maestro cli.
-# run: rnxsim maestro test .maestro/login.yaml
+  const starter = `# rnx maestro starter flow — drop-in compatible with the maestro cli.
+# run: rnx maestro test .maestro/login.yaml
 appId: com.example.app
 ---
 - launchApp
@@ -262,7 +262,7 @@ appId: com.example.app
 `
   fs.writeFileSync(outPath, starter, 'utf8')
   console.log(`  + wrote ${outPath}`)
-  console.log(`  next: rnxsim maestro test .maestro/login.yaml`)
+  console.log(`  next: rnx maestro test .maestro/login.yaml`)
   return 0
 }
 
@@ -343,8 +343,8 @@ export async function runMaestro(
     console.error(`
   error: no maestro flows found.
   expected one of: ${MAESTRO_DIRS.map((d) => `./${d}/`).join(', ')}
-  or pass a flow explicitly:    rnxsim maestro test path/to/flow.yaml
-  or scaffold a starter flow:   rnxsim maestro init
+  or pass a flow explicitly:    rnx maestro test path/to/flow.yaml
+  or scaffold a starter flow:   rnx maestro init
 `)
     return 1
   }
@@ -368,7 +368,7 @@ export async function runMaestro(
   }
 
   console.log(`
-  rnxsim maestro — ${files.length} flow${files.length === 1 ? '' : 's'}
+  rnx maestro — ${files.length} flow${files.length === 1 ? '' : 's'}
   root: ${path.relative(cwd, target) || '.'}
 `)
 

package/cli/commands/mode.ts

@@ -27,12 +27,12 @@ function withoutSubcommand(args: string[], index: number): string[] {
 
 function printHelp(): void {
   console.log(`
-rnxsim mode — toggle live display modes
+rnx mode — toggle live display modes
 
 usage:
-  rnxsim mode screenshot [on|off|toggle]
-  rnxsim mode three [on|off|toggle]
-  rnxsim mode three configure [options]
+  rnx mode screenshot [on|off|toggle]
+  rnx mode three [on|off|toggle]
+  rnx mode three configure [options]
 `)
 }
 

package/cli/commands/no-bridge-hint.ts

@@ -4,13 +4,13 @@ import { findDesktopCompanion } from '../desktop-companion'
 import type { BridgeSimInfo } from '../ws-bridge'
 
 export function printMissingCompanionHint() {
-  console.error('  no rnxsim desktop companion found.')
+  console.error('  no rnx desktop companion found.')
   console.error('')
   console.error('  install the desktop app:')
-  console.error('    rnxsim desktop install')
+  console.error('    rnx desktop install')
   console.error('')
   console.error('  or run setup to install the background daemon:')
-  console.error('    rnxsim setup')
+  console.error('    rnx setup')
   console.error('')
 }
 
@@ -19,12 +19,12 @@ export function printMissingBridgeHint(port: number) {
   console.log(`  note: no rnx bridge detected on port ${port}`)
   if (companion) {
     console.log(`  launch the installed companion with:`)
-    console.log(`    rnxsim desktop`)
+    console.log(`    rnx desktop`)
     return
   }
   console.log('')
-  console.log('  run `rnxsim setup` to install the background daemon,')
-  console.log('  or run `rnxsim serve` in another shell for a foreground bridge.')
+  console.log('  run `rnx setup` to install the background daemon,')
+  console.log('  or run `rnx serve` in another shell for a foreground bridge.')
 }
 
 export function printMissingSimHint(port: number) {
@@ -33,10 +33,10 @@ export function printMissingSimHint(port: number) {
   console.error('')
   console.error('  start your app dev server, then open it in rnx:')
   console.error('    npx expo start --localhost --port 8081')
-  console.error('    rnxsim open 8081')
+  console.error('    rnx open 8081')
   console.error('')
   console.error('  then inspect the live app:')
-  console.error('    rnxsim describe')
+  console.error('    rnx describe')
 }
 
 // printed when a command targeted a specific `--sim <id>` that the bridge
@@ -76,5 +76,5 @@ export async function printUnknownSimHint(
     console.error(`    ${sim.id}  (${flags})`)
   }
   console.error('')
-  console.error('  pass a valid --sim id, or run `rnxsim list` to see all sessions.')
+  console.error('  pass a valid --sim id, or run `rnx list` to see all sessions.')
 }

package/cli/commands/perf.ts

@@ -28,21 +28,21 @@ function withoutSubcommand(args: string[], index: number): string[] {
 
 function printHelp(): void {
   console.log(`
-rnxsim perf — performance profiling tools
+rnx perf — performance profiling tools
 
 usage:
-  rnxsim perf cpu [options]
-  rnxsim perf react <subcommand> [options]
-  rnxsim perf shell <start|stop|transition> [options]
-  rnxsim perf scroll <start|stop> [options]
+  rnx perf cpu [options]
+  rnx perf react <subcommand> [options]
+  rnx perf shell <start|stop|transition> [options]
+  rnx perf scroll <start|stop> [options]
 
 examples:
-  rnxsim perf cpu --duration 5 --output /tmp/trace.cpuprofile
-  rnxsim perf react summary --limit 10
-  rnxsim perf shell start
-  rnxsim perf shell stop --json
-  rnxsim perf scroll start
-  rnxsim perf scroll stop --json
+  rnx perf cpu --duration 5 --output /tmp/trace.cpuprofile
+  rnx perf react summary --limit 10
+  rnx perf shell start
+  rnx perf shell stop --json
+  rnx perf scroll start
+  rnx perf scroll stop --json
 `)
 }
 

package/cli/commands/permissions.ts

@@ -51,13 +51,13 @@ const KINDS: readonly SystemPermissionKind[] = [
 
 function printHelp(): void {
   console.log(`
-rnxsim permissions — inspect and change simulated operating-system permissions
+rnx permissions — inspect and change simulated operating-system permissions
 
 usage:
-  rnxsim permissions list [--json]
-  rnxsim permissions get <app-id> [--json]
-  rnxsim permissions set <app-id> <kind> <status> [--once] [--accuracy full|reduced] [--json]
-  rnxsim permissions reset <app-id> [kind] [--json]
+  rnx permissions list [--json]
+  rnx permissions get <app-id> [--json]
+  rnx permissions set <app-id> <kind> <status> [--once] [--accuracy full|reduced] [--json]
+  rnx permissions reset <app-id> [kind] [--json]
 `)
 }
 

package/cli/commands/profile.ts

@@ -15,25 +15,25 @@ interface ProfileOptions {
 
 function printHelp() {
   console.log(`
-rnxsim storage profile — manage isolated storage profiles
+rnx storage profile — manage isolated storage profiles
 
 usage:
-  rnxsim storage profile list
-  rnxsim storage profile create <id>
-  rnxsim storage profile clear <id>
-  rnxsim storage profile delete <id>
+  rnx storage profile list
+  rnx storage profile create <id>
+  rnx storage profile clear <id>
+  rnx storage profile delete <id>
 
 profiles isolate cookies, localStorage, IndexedDB, cache, permissions, and
 service workers in Electron and Playwright launches. Plain browser-tab launches
 cannot honor profiles and will fail clearly if a profile is requested.
 
 examples:
-  rnxsim storage profile list
-  rnxsim storage profile create qa
-  rnxsim open 8081 --profile qa
-  rnxsim open 8081 --profile qa --driver playwright
-  rnxsim storage profile clear qa
-  rnxsim storage profile delete qa
+  rnx storage profile list
+  rnx storage profile create qa
+  rnx open 8081 --profile qa
+  rnx open 8081 --profile qa --driver playwright
+  rnx storage profile clear qa
+  rnx storage profile delete qa
 `)
 }
 

package/cli/commands/react.ts

@@ -36,16 +36,16 @@ interface TreeRow {
 
 function printHelp() {
   console.log(`
-rnxsim perf react — inspect React component render cost in the tenant worker
+rnx perf react — inspect React component render cost in the tenant worker
 
 usage:
-  rnxsim perf react profile start [--include-props] [--max-commits N]
-  rnxsim perf react profile stop
-  rnxsim perf react summary [--limit 10] [--json]
-  rnxsim perf react slow [--limit 5] [--json]
-  rnxsim perf react rerenders [--limit 5] [--json]
-  rnxsim perf react tree [--depth 3] [--find <name>] [--json]
-  rnxsim perf react why <fiber-id> [--json]
+  rnx perf react profile start [--include-props] [--max-commits N]
+  rnx perf react profile stop
+  rnx perf react summary [--limit 10] [--json]
+  rnx perf react slow [--limit 5] [--json]
+  rnx perf react rerenders [--limit 5] [--json]
+  rnx perf react tree [--depth 3] [--find <name>] [--json]
+  rnx perf react why <fiber-id> [--json]
 
 \`react summary\` is the demo-friendly shortcut: it runs both slow and
 rerenders in one round-trip, prints them as a single table per side,
@@ -53,12 +53,12 @@ and surfaces the duration-zero warning prominently when the bundle is
 running without React profiler timers.
 
 examples:
-  rnxsim perf react profile start
-  rnxsim do tap-text Inbox
-  rnxsim perf react profile stop
-  rnxsim perf react summary --limit 10
-  rnxsim perf react slow --limit 10
-  rnxsim perf react rerenders --json
+  rnx perf react profile start
+  rnx do tap-text Inbox
+  rnx perf react profile stop
+  rnx perf react summary --limit 10
+  rnx perf react slow --limit 10
+  rnx perf react rerenders --json
 `)
 }
 
@@ -332,7 +332,7 @@ export async function runReact(args: string[], opts: ReactOptions): Promise<numb
     if (first === 'why') {
       const fiberId = Number(second)
       if (!Number.isFinite(fiberId) || fiberId <= 0) {
-        console.error('  usage: rnxsim perf react why <fiber-id>')
+        console.error('  usage: rnx perf react why <fiber-id>')
         return 1
       }
       const result = (await callInBridge(

package/cli/commands/record.ts

@@ -84,7 +84,7 @@ async function evalCaptureStep<T>(
         `  ${step} stalled — the render host did not finish within ` +
           `${Math.round(timeoutMs / 1000)}s; it is likely contended or wedged.\n` +
           `  the capture lock auto-releases, so simply retry the recording.\n` +
-          `  if it persists, recover the sim with \`rnxsim close --sim <id>\`.`,
+          `  if it persists, recover the sim with \`rnx close --sim <id>\`.`,
       )
       process.exit(1)
     }
@@ -105,7 +105,7 @@ async function evalCaptureStep<T>(
           `  releasing. the lock self-heals in ~${Math.round(
             (durationMs + 20_000) / 1000,
           )}s — retry then, or recover now with\n` +
-          `  \`rnxsim close --sim <id>\` and reopen the sim.`,
+          `  \`rnx close --sim <id>\` and reopen the sim.`,
       )
       process.exit(1)
     }
@@ -500,7 +500,7 @@ export async function runRecord(args: string[], opts: RecordOptions) {
         console.error(
           '  a prior recording was abandoned and its capture is still\n' +
             '  releasing. retry in ~20s, or recover now with\n' +
-            '  `rnxsim close --sim <id>` then reopen the sim.',
+            '  `rnx close --sim <id>` then reopen the sim.',
         )
       }
       process.exit(1)
@@ -561,7 +561,7 @@ async function probeSim(bridge: WsBridge, code: string): Promise<boolean> {
     if (/^command timed out after \d+s$/.test(msg)) {
       console.error(
         '  sim did not respond — it is connected to the bridge but has not\n' +
-          '  loaded an app (or its page is unresponsive). run `rnxsim list`\n' +
+          '  loaded an app (or its page is unresponsive). run `rnx list`\n' +
           '  and target a sim with a loaded app via --sim <id>.',
       )
       process.exit(1)
@@ -743,7 +743,7 @@ async function recordStart(args: string[], opts: RecordOptions) {
   const existing = readRecordingState()
   if (existing) {
     console.error(
-      `  recording already in progress (started ${existing.startedAt}, sim ${existing.simId ?? '?'}). run \`rnxsim record stop\` first, or \`rnxsim record cancel\` to discard.`,
+      `  recording already in progress (started ${existing.startedAt}, sim ${existing.simId ?? '?'}). run \`rnx record stop\` first, or \`rnx record cancel\` to discard.`,
     )
     process.exit(1)
   }
@@ -771,7 +771,7 @@ async function recordStart(args: string[], opts: RecordOptions) {
   const format = formatArg === 'mp4' ? 'mp4' : 'webm'
   if (formatArg && format !== formatArg) {
     console.error(
-      `  record start only supports webm or mp4 (got: ${formatArg}). for gif/png use atomic mode: rnxsim record --format ${formatArg} --duration <s>`,
+      `  record start only supports webm or mp4 (got: ${formatArg}). for gif/png use atomic mode: rnx record --format ${formatArg} --duration <s>`,
     )
     process.exit(1)
   }
@@ -854,11 +854,11 @@ async function recordStart(args: string[], opts: RecordOptions) {
     })
     if (mode === 'video') {
       console.log(
-        `  recording ${format} @ ${fps}fps${layers ? ` (${layers})` : ''} — run \`rnxsim record stop --output <path>\` when done`,
+        `  recording ${format} @ ${fps}fps${layers ? ` (${layers})` : ''} — run \`rnx record stop --output <path>\` when done`,
       )
     } else {
       console.log(
-        `  recording ${mode} — run \`rnxsim record stop\` when done (add --open to launch the preview URL)`,
+        `  recording ${mode} — run \`rnx record stop\` when done (add --open to launch the preview URL)`,
       )
     }
   } finally {
@@ -870,7 +870,7 @@ async function recordPreludeStart(args: string[], opts: RecordOptions) {
   const existing = readRecordingState()
   if (existing) {
     console.error(
-      `  recording already in progress (started ${existing.startedAt}, sim ${existing.simId ?? '?'}). run \`rnxsim record stop\` first, or \`rnxsim record cancel\` to discard.`,
+      `  recording already in progress (started ${existing.startedAt}, sim ${existing.simId ?? '?'}). run \`rnx record stop\` first, or \`rnx record cancel\` to discard.`,
     )
     process.exit(1)
   }
@@ -910,7 +910,7 @@ async function recordPreludeStart(args: string[], opts: RecordOptions) {
       process.exit(1)
     }
     console.log(
-      '  recording preview prelude — run `rnxsim record start --mode combined` when the visible proof segment is ready',
+      '  recording preview prelude — run `rnx record start --mode combined` when the visible proof segment is ready',
     )
   } finally {
     bridge.close()
@@ -1026,8 +1026,8 @@ async function recordStatus(args: string[], opts: RecordOptions) {
         console.log(
           '  a recording preview prelude is active. hidden setup is being\n' +
             '  captured for the next live/combined preview recording. finish\n' +
-            '  it with `rnxsim record start --mode combined`, or discard it\n' +
-            '  with `rnxsim record cancel`.',
+            '  it with `rnx record start --mode combined`, or discard it\n' +
+            '  with `rnx record cancel`.',
         )
         return
       }
@@ -1039,7 +1039,7 @@ async function recordStatus(args: string[], opts: RecordOptions) {
           '  (atomic `--mode video/gif/png` writes a local file from that\n' +
           '  process; live/combined upload to /preview/<id>). if the run was\n' +
           '  killed, the recording is abandoned and will NOT finish — reclaim\n' +
-          '  it now with `rnxsim record cancel`, or it auto-reclaims when the\n' +
+          '  it now with `rnx record cancel`, or it auto-reclaims when the\n' +
           "  abandoned capture's deadline lapses.",
       )
     } else {
@@ -1132,7 +1132,7 @@ async function recordCancel(args: string[], opts: RecordOptions) {
 async function recordStop(args: string[], opts: RecordOptions) {
   const state = readRecordingState()
   if (!state) {
-    console.error('  no recording in progress. start one with `rnxsim record start`.')
+    console.error('  no recording in progress. start one with `rnx record start`.')
     process.exit(1)
   }
 
@@ -1307,7 +1307,7 @@ async function injectPreviewSessionAuth(
     console.error(
       '  SootSim.bridges.setSession missing — this sim is running an engine\n' +
         '  build without CLI-injected preview auth. reload the sim or open a\n' +
-        '  fresh one (`rnxsim open --new`); if it persists, update rnx.',
+        '  fresh one (`rnx open --new`); if it persists, update rnx.',
     )
     process.exit(1)
   }

package/cli/commands/report-issue.ts

@@ -214,7 +214,7 @@ export async function runReportIssue(
   } catch (error) {
     dependencies.stderr(
       `  ${error instanceof Error ? error.message : String(error)}\n` +
-        `  usage: rnxsim report-issue [--app <dir>] [--dry-run] [--yes] "<description>"\n`,
+        `  usage: rnx report-issue [--app <dir>] [--dry-run] [--yes] "<description>"\n`,
     )
     return 1
   }
@@ -237,7 +237,7 @@ export async function runReportIssue(
   }
 
   dependencies.stdout(
-    `\n  rnxsim issue report preview\n\n` +
+    `\n  rnx issue report preview\n\n` +
       `  description: ${payload.note}\n` +
       `  compatibility: ${compatibilitySummary(payload.bundle.compatibility)}\n` +
       `  environment: CLI ${payload.bundle.cliVersion}, runtime ${

package/cli/commands/reset.ts

@@ -15,10 +15,10 @@ function isResetResult(value: unknown): value is ResetResult {
 
 function printHelp(): void {
   console.log(`
-rnxsim reset - clear the current guest app and relaunch it
+rnx reset - clear the current guest app and relaunch it
 
 usage:
-  rnxsim reset [--full] [--json] [--sim <id>]
+  rnx reset [--full] [--json] [--sim <id>]
 
 options:
   --full      also clear keychain, user defaults, and permissions

package/cli/commands/runtime.ts

@@ -62,15 +62,15 @@ export async function runRuntime(args: string[], opts: RuntimeOptions = {}) {
 
 function printHelp() {
   console.log(`
-rnxsim runtime — manage engine runtimes under ~/.sootsim/runtimes/
+rnx runtime — manage engine runtimes under ~/.sootsim/runtimes/
 
 usage:
-  rnxsim runtime install [version]   install a version (default: channel latest)
-  rnxsim runtime list                show installed + available versions
-  rnxsim runtime use <version>       switch active runtime
-  rnxsim runtime remove <version>    delete an installed runtime
-  rnxsim runtime which               print active runtime version
-  rnxsim runtime notes               print repo or default engine release notes
+  rnx runtime install [version]   install a version (default: channel latest)
+  rnx runtime list                show installed + available versions
+  rnx runtime use <version>       switch active runtime
+  rnx runtime remove <version>    delete an installed runtime
+  rnx runtime which               print active runtime version
+  rnx runtime notes               print repo or default engine release notes
 
 flags:
   --channel <name>    channel to resolve 'latest' from (default: stable)
@@ -81,11 +81,11 @@ environment:
   SOOTSIM_CDN_ORIGIN  override the CDN base URL (default: ${DEFAULT_RUNTIME_CDN_ORIGIN})
 
 examples:
-  rnxsim runtime install
-  rnxsim runtime install 1.2.3
-  rnxsim runtime install --channel beta
-  rnxsim runtime use 1.2.3
-  rnxsim runtime notes
+  rnx runtime install
+  rnx runtime install 1.2.3
+  rnx runtime install --channel beta
+  rnx runtime use 1.2.3
+  rnx runtime notes
 `)
 }
 
@@ -99,7 +99,7 @@ async function runtimeInstall(args: string[], opts: RuntimeOptions) {
 
   ensureSootsimHome()
 
-  console.log(`rnxsim runtime install`)
+  console.log(`rnx runtime install`)
   console.log(`  cdn:     ${sootsimRuntime.resolveCdnOrigin()}`)
 
   try {
@@ -233,14 +233,14 @@ async function runtimeList(_args: string[]) {
 async function runtimeUse(args: string[]) {
   const version = args[0]
   if (!version) {
-    console.error(`  usage: rnxsim runtime use <version>`)
+    console.error(`  usage: rnx runtime use <version>`)
     process.exit(1)
   }
   const installed = sootsimRuntime.listInstalled()
   if (!installed.includes(version)) {
     console.error(`  version ${version} is not installed`)
     console.error(`  installed: ${installed.join(', ') || '(none)'}`)
-    console.error(`  run \`rnxsim runtime install ${version}\` first`)
+    console.error(`  run \`rnx runtime install ${version}\` first`)
     process.exit(1)
   }
   await activateVersion(version)
@@ -251,14 +251,14 @@ async function runtimeUse(args: string[]) {
 async function runtimeRemove(args: string[]) {
   const version = args[0]
   if (!version) {
-    console.error(`  usage: rnxsim runtime remove <version>`)
+    console.error(`  usage: rnx runtime remove <version>`)
     process.exit(1)
   }
   const active = readActiveRuntime()
   if (active === version) {
     console.error(`  cannot remove active runtime ${version}`)
     console.error(
-      `  switch with \`rnxsim runtime use <other>\` first, or install another version`,
+      `  switch with \`rnx runtime use <other>\` first, or install another version`,
     )
     process.exit(1)
   }
@@ -290,7 +290,7 @@ async function runtimeWhich() {
 
 async function runtimeNotes(args: string[]) {
   if (args.length > 0) {
-    console.error(`  usage: rnxsim runtime notes`)
+    console.error(`  usage: rnx runtime notes`)
     process.exit(1)
   }
   const { config } = await resolveSootSimAppConfig()

package/cli/commands/screenshot-mode.ts

@@ -11,10 +11,10 @@ import { runShellBooleanMode, type ShellBooleanModeOptions } from './shell-boole
 export async function runScreenshotMode(args: string[], opts: ShellBooleanModeOptions) {
   if (args.includes('--help') || args.includes('-h')) {
     console.log(`
-rnxsim mode screenshot — toggle the screenshot-mode chrome overlay
+rnx mode screenshot — toggle the screenshot-mode chrome overlay
 
 usage:
-  rnxsim mode screenshot [on|off|toggle]
+  rnx mode screenshot [on|off|toggle]
 
 arguments:
   on        enable screenshot mode (enables showFrame if needed)
@@ -22,9 +22,9 @@ arguments:
   toggle    flip the current state (default)
 
 examples:
-  rnxsim mode screenshot
-  rnxsim mode screenshot on
-  rnxsim mode screenshot off
+  rnx mode screenshot
+  rnx mode screenshot on
+  rnx mode screenshot off
 `)
     process.exit(0)
   }

package/cli/commands/screenshot.ts

@@ -34,11 +34,11 @@ export async function runScreenshot(rawArgs: string[], opts: ScreenshotOptions)
   const args = normalizeAliasFlags(rawArgs)
   if (args.includes('--help') || args.includes('-h')) {
     console.log(`
-rnxsim screenshot — capture the canvas as a PNG
+rnx screenshot — capture the canvas as a PNG
 
 usage:
-  rnxsim screenshot [output] [options]
-  rnxsim screenshot [options] --output <path>
+  rnx screenshot [output] [options]
+  rnx screenshot [options] --output <path>
 
 options:
   --output <path>     output file path (default: /tmp/sootsim-inspect.png)
@@ -58,11 +58,11 @@ options:
   --themes            capture light and dark variants
 
 examples:
-  rnxsim screenshot
-  rnxsim screenshot --no-shell --output app.png
-  rnxsim screenshot --with-frame --output framed.png
-  rnxsim screenshot --area 0,200,393,400 --output hero.png
-  rnxsim screenshot --id loginButton --output button.png
+  rnx screenshot
+  rnx screenshot --no-shell --output app.png
+  rnx screenshot --with-frame --output framed.png
+  rnx screenshot --area 0,200,393,400 --output hero.png
+  rnx screenshot --id loginButton --output button.png
 `)
     process.exit(0)
   }
@@ -76,7 +76,7 @@ examples:
           : `  unknown flag: ${flag}`,
       )
     }
-    console.error('  run `rnxsim screenshot --help` for the list of supported flags')
+    console.error('  run `rnx screenshot --help` for the list of supported flags')
     process.exit(1)
   }
 
@@ -146,7 +146,7 @@ examples:
   if (rect) {
     console.error('  --area / --id / --text require a running rnx bridge')
     console.error(
-      '  start one with `rnxsim serve`, `rnxsim desktop`, or your project dev server',
+      '  start one with `rnx serve`, `rnx desktop`, or your project dev server',
     )
     process.exit(1)
   }
@@ -216,7 +216,7 @@ async function captureViaBridge(
       process.stderr.write(
         '  ⚠ screenshot will capture the LAST PAINTED canvas — likely stale.\n' +
           '  navigation/`shell` commands sent before this screenshot may not\n' +
-          '  have repainted yet. focus the tab manually or `rnxsim --sim <id>`\n' +
+          '  have repainted yet. focus the tab manually or `rnx --sim <id>`\n' +
           '  to target a visible sim before capturing.\n\n',
       )
     }
@@ -288,7 +288,7 @@ async function captureViaBridge(
     // the sim may be alive but not painting (check `sootsim get errors`)
     if (typeof dataUrl !== 'string' || dataUrl.length <= pngPrefix.length) {
       throw new Error(
-        'screenshot capture returned no image data — the sim is connected but not painting; check `rnxsim get errors`',
+        'screenshot capture returned no image data — the sim is connected but not painting; check `rnx get errors`',
       )
     }
     const base64 = dataUrl.replace(/^data:image\/png;base64,/, '')