rnxsim 0.1.376 → 0.1.377

package/cli/commands/maestro-generate.ts

@@ -1,4 +1,4 @@
-// plain-language Maestro authoring for `sootsim maestro generate`.
+// plain-language Maestro authoring for `rnx maestro generate`.
 
 import { mkdtempSync, writeFileSync } from 'fs'
 import { tmpdir } from 'os'
@@ -10,7 +10,7 @@ import { createBridgeFromParsed, parseBridgeCliArgs } from '../ws-bridge'
 import { inspectDescribe } from './inspect/core'
 import { resolveDefaultUploadOrigin } from './upload'
 
-const DEFAULT_TEST_MODEL = process.env.SOOTSIM_TEST_MODEL || 'deepseek-v4-flash'
+const DEFAULT_TEST_MODEL = process.env.RNX_TEST_MODEL || 'deepseek-v4-flash'
 const DESCRIBE_CONTEXT_LIMIT = 18_000
 const LLM_TIMEOUT_MS = 180_000
 
@@ -96,7 +96,7 @@ async function describeCurrentSim(args: string[], promptIndex: number): Promise<
   }
 }
 
-const SOOTSIM_TEST_SYSTEM_PROMPT = `
+const RNX_TEST_SYSTEM_PROMPT = `
 You write Maestro-compatible rnx YAML flows from a user's plain-language test goal.
 Return only JSON, no markdown, with this exact shape:
 {"summary":"short human-readable result goal","steps":[{"waitFor":{"text":"...","timeout":10000}}]}
@@ -145,7 +145,7 @@ async function generateFlowJson(args: {
     body: JSON.stringify({
       modelId: DEFAULT_TEST_MODEL,
       context: {
-        systemPrompt: SOOTSIM_TEST_SYSTEM_PROMPT,
+        systemPrompt: RNX_TEST_SYSTEM_PROMPT,
         messages: [
           {
             role: 'user',
@@ -320,7 +320,7 @@ export async function runMaestroGenerate(args: string[]): Promise<number> {
   console.log('  generating Maestro flow…')
   const generated = await generateFlowJson({ prompt, describe, origin, authHeader })
   const flow = parseGeneratedFlow(generated)
-  const tempDir = mkdtempSync(join(tmpdir(), 'sootsim-maestro-generate-'))
+  const tempDir = mkdtempSync(join(tmpdir(), 'rnx-maestro-generate-'))
   const flowPath = join(tempDir, 'flow.yaml')
   writeFileSync(flowPath, flow.yamlText)
   console.log(`  flow: ${flowPath}`)

package/cli/commands/maestro.ts

@@ -1,7 +1,7 @@
-// sootsim maestro — drop-in replacement for the real `maestro` cli.
+// rnx maestro — drop-in replacement for the real `maestro` cli.
 //
 // users with an existing `.maestro/` directory can swap `maestro test`
-// for `sootsim maestro test` and have their flows execute against
+// for `rnx maestro test` and have their flows execute against
 // sootsim's in-browser engine. the heavy lifting lives in `flow.ts` +
 // `bridge-flow-runner.ts`; this file just re-maps the maestro argv shape
 // onto the existing flow runner and handles directory iteration + init.
@@ -145,7 +145,7 @@ function applyEnvFlags(args: string[]): string[] {
 }
 
 // Remove Maestro-only flags that the shared runner does not know.
-// these are accepted so users can literally s/maestro/sootsim maestro/ in
+// these are accepted so users can literally s/maestro/rnx maestro/ in
 // their scripts without edits.
 function stripUnknownMaestroFlags(args: string[]): string[] {
   const out: string[] = []
@@ -324,7 +324,7 @@ export async function runMaestro(
   let forwardArgs: string[]
 
   if (sub === 'test') {
-    // `sootsim maestro test <flow-or-dir> [flags...]`
+    // `rnx maestro test <flow-or-dir> [flags...]`
     const positional = remaining.slice(1).find((a) => !looksLikeFlag(a))
     if (positional) {
       target = path.resolve(cwd, positional)
@@ -334,7 +334,7 @@ export async function runMaestro(
       forwardArgs = remaining.slice(1)
     }
   } else if (sub && !looksLikeFlag(sub)) {
-    // `sootsim maestro <flow-or-dir>` — tolerate the shorthand.
+    // `rnx maestro <flow-or-dir>` — tolerate the shorthand.
     target = path.resolve(cwd, sub)
     forwardArgs = remaining.slice(1)
   } else {

package/cli/commands/profile.ts

@@ -1,4 +1,4 @@
-// sootsim storage profile — manage isolated app storage profiles.
+// rnx storage profile — manage isolated app storage profiles.
 
 import {
   clearProfileStorage,

package/cli/commands/record.ts

@@ -1,4 +1,4 @@
-// sootsim record — drives the engine's built-in canvas recorder over
+// rnx record — drives the engine's built-in canvas recorder over
 // the WS bridge. no playwright, no ffmpeg. encoding happens in the
 // running sootsim page (webm via MediaRecorder, mp4 via WebCodecs, gif
 // via gifenc, raw png frames via a shared bitmap sampler).
@@ -375,7 +375,7 @@ export async function runRecord(args: string[], opts: RecordOptions) {
 
     if (format === 'png') {
       const count = framesCount ?? 10
-      const outDir = resolveRecordingOutput(outputArg, `sootsim-frames-${stamp()}`)
+      const outDir = resolveRecordingOutput(outputArg, `rnx-frames-${stamp()}`)
       // --frames writes one png PER frame, so --output names a directory, not
       // a file. a caller passing `--output shot.png` gets a directory literally
       // named `shot.png` — flag the likely mistake rather than silently doing it.
@@ -445,7 +445,7 @@ export async function runRecord(args: string[], opts: RecordOptions) {
 
     if (format === 'gif') {
       const count = framesCount ?? Math.max(10, Math.round((durationSec * fps) / 3))
-      const out = resolveRecordingOutput(outputArg, `sootsim-${stamp()}.gif`)
+      const out = resolveRecordingOutput(outputArg, `rnx-${stamp()}.gif`)
       mkdirSync(dirname(out), { recursive: true })
       console.log(`  encoding gif: ${count} frames over ${durationSec}s → ${out}`)
       const result: { data: string; size: number } | null = await evalCaptureStep(
@@ -466,7 +466,7 @@ export async function runRecord(args: string[], opts: RecordOptions) {
     }
 
     // video path: webm or mp4
-    const out = resolveRecordingOutput(outputArg, `sootsim-${stamp()}.${format}`)
+    const out = resolveRecordingOutput(outputArg, `rnx-${stamp()}.${format}`)
     mkdirSync(dirname(out), { recursive: true })
 
     const startOpts: {
@@ -658,10 +658,10 @@ function stamp(): string {
 
 // default home for recordings when --output is omitted. writing into the
 // process cwd litters whatever directory the CLI was invoked from (the repo
-// root, most often) with sootsim-*.mp4 / sootsim-frames-*/ — F11-2. an
+// root, most often) with rnx-*.mp4 / rnx-frames-*/ — F11-2. an
 // explicit --output still resolves relative to cwd as the caller expects.
 function recordingsDir(): string {
-  const dir = join(homedir(), '.sootsim', 'recordings')
+  const dir = join(homedir(), '.rnx', 'recordings')
   mkdirSync(dir, { recursive: true })
   return dir
 }
@@ -698,7 +698,7 @@ function parseMode(raw: string | undefined): RecordMode {
 }
 
 function recordingStatePath(): string {
-  return join(tmpdir(), `sootsim-recording-${getCliIdentityKey()}.json`)
+  return join(tmpdir(), `rnx-recording-${getCliIdentityKey()}.json`)
 }
 
 function readRecordingState(): RecordingState | null {
@@ -1165,7 +1165,7 @@ async function recordStop(args: string[], opts: RecordOptions) {
     }
 
     const outputArg = valueOf(args, '--output')
-    const out = resolveRecordingOutput(outputArg, `sootsim-${stamp()}.${state.format}`)
+    const out = resolveRecordingOutput(outputArg, `rnx-${stamp()}.${state.format}`)
     mkdirSync(dirname(out), { recursive: true })
     const stopResult: {
       ok: boolean
@@ -1219,7 +1219,7 @@ async function assertStoreBridgesAvailable(bridge: WsBridge) {
 
 // CLI-driven live/combined recording runs in a headless browser that was
 // never logged in, so browser-side upload has no bearer. push the CLI's own
-// auth — the same RNX_API_KEY / `sootsim login` / GitHub token
+// auth — the same RNX_API_KEY / `rnx login` / GitHub token
 // ensureCliRecordingEntitlement just verified — into the page's shared-session
 // store before starting. GitHub PR-preview auth also needs its repo identity
 // in the upload init body so the server treats the bearer as a GitHub upload

package/cli/commands/runtime.ts

@@ -1,21 +1,21 @@
-// sootsim runtime — manage engine runtimes under ~/.sootsim/runtimes/.
+// rnx runtime — manage engine runtimes under ~/.rnx/runtimes/.
 //
 // runtimes are versioned tarballs hosted behind the configured CDN origin
 // (default https://contrast.dev/runtimes/). each install:
 //   1. fetches manifest.json to resolve a version (or confirm the literal)
 //   2. downloads sootsim-runtime-<version>.tar.gz to an operation temp directory
 //   3. verifies sha256
-//   4. extracts to ~/.sootsim/runtimes/<version>/
+//   4. extracts to ~/.rnx/runtimes/<version>/
 //   5. (optionally) sets it active + tells the daemon to hot-swap
 //
-// the daemon-side state (active runtime) is mirrored in ~/.sootsim/runtimes/active
+// the daemon-side state (active runtime) is mirrored in ~/.rnx/runtimes/active
 // so the CLI can change it even when the daemon isn't running.
 
 import fs from 'fs'
 import { compareSemver } from '@contrast/runtime-delivery'
 import { WebSocket } from 'ws'
 import {
-  ensureSootsimHome,
+  ensureRnxHome,
   readActiveRuntime,
   readLiveRuntimeVersions,
   runtimeDir,
@@ -23,10 +23,10 @@ import {
 } from '../../src/home-paths'
 import {
   DEFAULT_RUNTIME_CDN_ORIGIN,
-  SOOTSIM_CHANGELOG_URL,
-  sootsimRuntime,
+  RNX_CHANGELOG_URL,
+  rnxRuntime,
 } from '../../src/runtime-delivery'
-import { resolveSootSimAppConfig } from '../app-config'
+import { resolveRNXAppConfig } from '../app-config'
 import { rnxExit } from '../run-rnx'
 import { fetchRuntimeReleaseNotes, formatRuntimeReleaseNotes } from '../runtime-notes'
 import { resolveDefaultBridgePort } from '../ws-bridge'
@@ -63,7 +63,7 @@ export async function runRuntime(args: string[], opts: RuntimeOptions = {}) {
 
 function printHelp() {
   console.log(`
-rnx runtime — manage engine runtimes under ~/.sootsim/runtimes/
+rnx runtime — manage engine runtimes under ~/.rnx/runtimes/
 
 usage:
   rnx runtime install [version]   install a version (default: channel latest)
@@ -79,7 +79,7 @@ flags:
   --set-active=false  do not switch active runtime after install
 
 environment:
-  SOOTSIM_CDN_ORIGIN  override the CDN base URL (default: ${DEFAULT_RUNTIME_CDN_ORIGIN})
+  RNX_CDN_ORIGIN  override the CDN base URL (default: ${DEFAULT_RUNTIME_CDN_ORIGIN})
 
 examples:
   rnx runtime install
@@ -98,13 +98,13 @@ async function runtimeInstall(args: string[], opts: RuntimeOptions) {
   const force = flags.force === true
   const setActive = flags.setActive !== false
 
-  ensureSootsimHome()
+  ensureRnxHome()
 
   console.log(`rnx runtime install`)
-  console.log(`  cdn:     ${sootsimRuntime.resolveCdnOrigin()}`)
+  console.log(`  cdn:     ${rnxRuntime.resolveCdnOrigin()}`)
 
   try {
-    const result = await sootsimRuntime.install({
+    const result = await rnxRuntime.install({
       version: versionArg,
       channel,
       force,
@@ -201,8 +201,8 @@ async function tellDaemonRuntimeChanged(version: string): Promise<boolean> {
 // --- list -----------------------------------------------------------------
 
 async function runtimeList(_args: string[]) {
-  ensureSootsimHome()
-  const installed = sootsimRuntime.listInstalled()
+  ensureRnxHome()
+  const installed = rnxRuntime.listInstalled()
   const active = readActiveRuntime()
   console.log(`installed:`)
   if (installed.length === 0) {
@@ -214,7 +214,7 @@ async function runtimeList(_args: string[]) {
     }
   }
   try {
-    const manifest = await sootsimRuntime.fetchManifest()
+    const manifest = await rnxRuntime.fetchManifest()
     console.log(`available (latest per channel):`)
     for (const [name, ch] of Object.entries(manifest.channels)) {
       console.log(`  ${name.padEnd(8)} ${ch.latest}`)
@@ -237,7 +237,7 @@ async function runtimeUse(args: string[]) {
     console.error(`  usage: rnx runtime use <version>`)
     rnxExit(1)
   }
-  const installed = sootsimRuntime.listInstalled()
+  const installed = rnxRuntime.listInstalled()
   if (!installed.includes(version)) {
     console.error(`  version ${version} is not installed`)
     console.error(`  installed: ${installed.join(', ') || '(none)'}`)
@@ -294,11 +294,11 @@ async function runtimeNotes(args: string[]) {
     console.error(`  usage: rnx runtime notes`)
     rnxExit(1)
   }
-  const { config } = await resolveSootSimAppConfig()
+  const { config } = await resolveRNXAppConfig()
   const version = config?.runtimeVersion ?? readActiveRuntime()
   if (!version) {
     console.log(`  no active runtime`)
-    console.log(`  release notes: ${SOOTSIM_CHANGELOG_URL}`)
+    console.log(`  release notes: ${RNX_CHANGELOG_URL}`)
     return
   }
   console.log(formatRuntimeReleaseNotes(version, await fetchRuntimeReleaseNotes(version)))

package/cli/commands/screenshot-command.ts

@@ -85,7 +85,7 @@ export async function runScreenshotCommand(
     // repo-only tooling: screenshots-capture statically imports playwright-core,
     // which the published CLI never ships (it's external in build-cli.ts). a
     // static import here would put that bare import at the top of THIS chunk,
-    // so every published `sootsim screenshot` printed ERR_MODULE_NOT_FOUND —
+    // so every published `rnx screenshot` printed ERR_MODULE_NOT_FOUND —
     // keep it a runtime dynamic import that only evaluates when capture runs.
     try {
       const { runScreenshotsCapture } = await import('./screenshots-capture')

package/cli/commands/screenshot-layers.ts

@@ -1,4 +1,4 @@
-// sootsim screenshot layers — engine-rendered layer isolation export.
+// rnx screenshot layers — engine-rendered layer isolation export.
 //
 // captures one screen as a stack the 3d stage can pull apart: `full.png` is
 // the normal frame, `base.png` re-renders the frame with the target subtrees
@@ -26,14 +26,14 @@ export async function runScreenshotLayers(
 ): Promise<void> {
   if (args.includes('--help') || args.includes('-h')) {
     console.log(`
-sootsim screenshot layers — export a screen as engine-isolated layers
+rnx screenshot layers — export a screen as engine-isolated layers
 
 usage:
-  sootsim screenshot layers --ids <testID,testID,...> [--out-dir <dir>]
+  rnx screenshot layers --ids <testID,testID,...> [--out-dir <dir>]
 
 options:
   --ids <list>       comma-separated testIDs of the subtrees to isolate
-  --out-dir <dir>    output directory (default: /tmp/sootsim-layers)
+  --out-dir <dir>    output directory (default: /tmp/rnx-layers)
 
 output:
   full.png           the normal frame
@@ -58,7 +58,7 @@ output:
     rnxExit(1)
   }
   const outDirArg = args.find((_, i) => args[i - 1] === '--out-dir')
-  const outDir = resolve(process.cwd(), outDirArg ?? '/tmp/sootsim-layers')
+  const outDir = resolve(process.cwd(), outDirArg ?? '/tmp/rnx-layers')
 
   const parsed = parseBridgeCliArgs(args, {
     port: opts.port,

package/cli/commands/screenshot-mode.ts

@@ -1,4 +1,4 @@
-// sootsim mode screenshot — toggle the "screenshot mode" chrome overlay
+// rnx mode screenshot — toggle the "screenshot mode" chrome overlay
 // in the running sootsim sim. orthogonal to `--no-shell` on the
 // `screenshot` command: this hides the DOM browser chrome (rail, menubar,
 // window controls) while still rendering the iOS shell inside the canvas.

package/cli/commands/screenshot.ts

@@ -1,4 +1,4 @@
-// sootsim screenshot — capture the canvas as a PNG
+// rnx screenshot — capture the canvas as a PNG
 //
 // prefers the WS bridge when one is reachable so the screenshot comes from
 // the user's current sim (and can be cropped to a logical
@@ -42,7 +42,7 @@ usage:
   rnx screenshot [options] --output <path>
 
 options:
-  --output <path>     output file path (default: /tmp/sootsim-inspect.png)
+  --output <path>     output file path (default: /tmp/rnx-inspect.png)
                       first positional arg works too: \`screenshot /tmp/x.png\`
   --with-frame        wrap the captured screen in a tight device frame
   --no-frame          capture the raw screen bitmap (default)
@@ -222,7 +222,7 @@ async function captureViaBridge(
       )
     }
     // re-assert readiness on THIS bridge connection right before capturing.
-    // the readiness gate (`sootsim wait ready`) and this capture run as
+    // the readiness gate (`rnx wait ready`) and this capture run as
     // separate CLI processes; between them the engine can re-enter its
     // boot/connect overlay — a late reload fires `sootsim:externalAppReloadStart`
     // and clears `__sootsimExternalAppReady` — so a capture taken now can grab
@@ -286,7 +286,7 @@ async function captureViaBridge(
     const dataUrl: string = await bridge.send(request)
     const pngPrefix = 'data:image/png;base64,'
     // never write a 0-byte "saved" file from an empty or malformed payload —
-    // the sim may be alive but not painting (check `sootsim get errors`)
+    // the sim may be alive but not painting (check `rnx 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 `rnx get errors`',
@@ -300,7 +300,7 @@ async function captureViaBridge(
     }
     if (layers) console.log(`  layers: ${layers}`)
 
-    const outputPath = resolve(process.cwd(), outputArg || '/tmp/sootsim-inspect.png')
+    const outputPath = resolve(process.cwd(), outputArg || '/tmp/rnx-inspect.png')
     mkdirSync(dirname(outputPath), { recursive: true })
     const rawBuffer = Buffer.from(base64, 'base64')
     if (withFrame) {
@@ -347,7 +347,7 @@ function resolveLayers(args: string[]): 'full' | 'tenant' | 'shell' | undefined
   return undefined
 }
 
-// known flags for `sootsim screenshot`. booleans take no value, value flags
+// known flags for `rnx screenshot`. booleans take no value, value flags
 // consume the next arg. kept local so this validation can't drift from the
 // flags the command actually reads.
 const SCREENSHOT_BOOLEAN_FLAGS = new Set([
@@ -435,7 +435,7 @@ function findUnknownFlags(args: string[]): Array<{ flag: string; suggestion?: st
 }
 
 // resolve output path: prefer --output <path>, fall back to the first
-// positional arg so `sootsim screenshot /tmp/foo.png` works the way every
+// positional arg so `rnx screenshot /tmp/foo.png` works the way every
 // other screenshot tool does.
 function resolveOutputPath(args: string[]): string | undefined {
   const explicit = args.find((_, i) => args[i - 1] === '--output')
@@ -454,7 +454,7 @@ function resolveOutputPath(args: string[]): string | undefined {
 // legacy playwright path kept for --gallery / --themes and for no-bridge
 // captures from CI. unchanged except for being extracted into its own fn.
 async function runPlaywrightScreenshot(args: string[], opts: ScreenshotOptions) {
-  const output = resolveOutputPath(args) || 'sootsim-screenshot.png'
+  const output = resolveOutputPath(args) || 'rnx-screenshot.png'
   const gallery = args.includes('--gallery')
   const url =
     args.find((_, i) => args[i - 1] === '--url') ||

package/cli/commands/screenshots-capture.ts

@@ -1,13 +1,13 @@
-// sootsim screenshot appstore capture — headlessly (re)capture an app's App-Store
+// rnx screenshot appstore capture — headlessly (re)capture an app's App-Store
 // slides as EDITABLE 3-layer refs (captureRef + cleanRef + screenRef, plus
 // threeScene for 3d) and let the shell's existing auto-upload push them to the
 // signed-in user's org deck. NOT a reimplementation of capture/upload: it
 // launches a GPU headless Chrome, loads the org-mode build shell, seeds the
-// `sootsim login` session into the page so the in-browser auto-upload PUTs
+// `rnx login` session into the page so the in-browser auto-upload PUTs
 // authenticate as the user, drives the same `SootSim.bridges.screenshotControl`
 // surface the rail UI uses, then waits for the deck/capture PUTs to flush.
 //
-// auth: `sootsim login` (resolveCliAuth → session token). the token is seeded
+// auth: `rnx login` (resolveCliAuth → session token). the token is seeded
 // into the shell page's localStorage (`sootsim.session.token`) — the exact key
 // `getSession()` reads, which both the deck PUT (projects-persistence) and the
 // per-ref capture PUT (capture-store) attach as `Authorization: Bearer`.
@@ -121,7 +121,7 @@ function parseFlags(args: string[]): Flags {
 // the session token + origin power both the page auth seed and the API calls.
 // only a logged-in session works here (the in-browser PUTs read a bearer); an
 // api-key/github CliAuth has no browser session origin, so we direct those to
-// `sootsim login` rather than silently failing mid-capture.
+// `rnx login` rather than silently failing mid-capture.
 function resolveSessionAuth(): { token: string; origin: string } {
   const auth: CliAuth | null = resolveCliAuth()
   if (auth && auth.kind === 'session') return { token: auth.token, origin: auth.origin }
@@ -417,7 +417,7 @@ export async function runScreenshotsCapture(args: string[]): Promise<number> {
     `${shellOrigin}/build/${encodeURIComponent(flags.org)}/${encodeURIComponent(flags.repo)}/` +
     `${encodeURIComponent(flags.branch)}?platform=${encodeURIComponent(flags.platform)}&ssMode=1`
 
-  const profileDir = mkdtempSync(join(tmpdir(), 'sootsim-capture-'))
+  const profileDir = mkdtempSync(join(tmpdir(), 'rnx-capture-'))
   const { browser: ctx, reapNow } = await launchReapedChromeScoped(
     (options) => chromium.launchPersistentContext(profileDir, options),
     {

package/cli/commands/serve.ts

@@ -1,4 +1,4 @@
-// sootsim serve — foreground bridge host
+// rnx serve — foreground bridge host
 //
 // hosts the WS bridge + runtime HTTP server on port 7668 (or --port) so
 // CLI commands and electron windows both work against one bridge. sims
@@ -10,7 +10,7 @@
 
 import { DEFAULT_SOOTSIM_BRIDGE_PORT } from '../../src/bridge-constants'
 import {
-  ensureSootsimHome,
+  ensureRnxHome,
   isDaemonLockfileFresh,
   readDaemonLockfile,
 } from '../../src/home-paths'
@@ -68,7 +68,7 @@ examples:
     rnxExit(1)
   }
 
-  ensureSootsimHome()
+  ensureRnxHome()
   // use the explicit upload/auth origin when configured, otherwise production.
   // never probe a local Contrast stack during bridge startup.
   const contrastOrigin = await resolveDefaultUploadOrigin()

package/cli/commands/setup.ts

@@ -15,7 +15,7 @@ import {
   writeOnboardingPreferences,
   writePrivacyPreferences,
 } from '../../src/home-paths'
-import { sootsimRuntime } from '../../src/runtime-delivery'
+import { rnxRuntime } from '../../src/runtime-delivery'
 import { findDesktopCompanion } from '../desktop-companion'
 import { confirm, select } from '../prompt'
 import {
@@ -87,17 +87,23 @@ export async function runSetup(
     const serviceStatus = getDaemonServiceStatus()
     const privacy = readPrivacyPreferences()
     const service = await decideService(options, serviceStatus)
+    if (options.dryRun && service && !serviceStatus.installed && !options.json) {
+      console.log(`  ${muted('Would enable')} ${accent('the background service')}`)
+    }
     if (!service && !serviceStatus.installed && !options.json) {
       console.log(`  ${muted('Enable it later with')} ${accent('rnx daemon install')}`)
     }
     const simulatorDriver = await decideSimulatorDriver(options)
+    if (options.dryRun && !options.json) {
+      console.log(
+        `  ${muted('Would use')} ${accent(simulatorDriver === 'playwright' ? 'Browser' : 'Desktop')}`,
+      )
+    }
 
     const manifest = options.json
-      ? await sootsimRuntime.fetchManifest()
-      : await withSpinner('Checking the rnx runtime', () =>
-          sootsimRuntime.fetchManifest(),
-        )
-    const runtimeVersion = sootsimRuntime.resolveVersion(manifest, {
+      ? await rnxRuntime.fetchManifest()
+      : await withSpinner('Checking the rnx runtime', () => rnxRuntime.fetchManifest())
+    const runtimeVersion = rnxRuntime.resolveVersion(manifest, {
       channel: 'stable',
     }).version
     const cliVersion = getCliVersion()
@@ -109,7 +115,7 @@ export async function runSetup(
     if (!options.dryRun) {
       const activeRuntime = readActiveRuntime()
       const install = () =>
-        sootsimRuntime.install({
+        rnxRuntime.install({
           version: runtimeVersion,
           channel: 'stable',
           setActive: true,
@@ -196,7 +202,9 @@ export async function runSetup(
       )
     } else {
       console.log(
-        `\n  ${success('✓')} ${launchConnectRN ? 'ConnectRN is open. ' : ''}rnx is ready.`,
+        options.dryRun
+          ? `\n  ${success('✓')} Dry run complete.`
+          : `\n  ${success('✓')} ${launchConnectRN ? 'ConnectRN is open. ' : ''}rnx is ready.`,
       )
     }
 
@@ -282,7 +290,7 @@ async function decideService(
     return true
   }
   if (options.service !== undefined) return options.service
-  if (options.yes) return true
+  if (options.yes || options.dryRun) return true
   requireInteractive(options, '--service or --no-service')
   printPromptBlock('Background service', [
     'Keeps the local bridge and runtime ready between commands.',
@@ -297,7 +305,7 @@ async function decideSimulatorDriver(
   if (options.simulatorDriver) return options.simulatorDriver
   const current = readSimulatorDriverPreference()
   if (current) return current
-  if (options.ci || options.yes) return 'playwright'
+  if (options.ci || options.yes || options.dryRun) return 'playwright'
   requireInteractive(options, '--desktop or --browser')
   const desktopDescription =
     process.platform === 'darwin'
@@ -368,7 +376,7 @@ function runtimeCacheMetadata(runtimeVersion: string) {
   const arch = os.arch()
   return {
     path: runtimeDir(runtimeVersion),
-    key: `sootsim-runtime-${platform}-${arch}-${runtimeVersion}`,
+    key: `rnx-runtime-${platform}-${arch}-${runtimeVersion}`,
     inputs: { platform, arch, runtimeVersion },
   }
 }
@@ -390,7 +398,7 @@ usage:
   rnx setup
   rnx setup --yes
   rnx setup --ci --yes --json
-  rnx setup --dry-run --yes
+  rnx setup --dry-run
 
 choices:
   --service | --no-service

package/cli/commands/skills.ts

@@ -1,9 +1,9 @@
-// sootsim skill - install and inspect agent skill files
+// rnx skill - install and inspect agent skill files
 //
 // usage:
-//   sootsim skill install              install all skills to supported agents
-//   sootsim skill install codex debug  install specific skills to Codex only
-//   sootsim skill show [name]          list skills or print one skill
+//   rnx skill install              install all skills to supported agents
+//   rnx skill install codex debug  install specific skills to Codex only
+//   rnx skill show [name]          list skills or print one skill
 
 import * as fs from 'fs'
 import * as os from 'os'
@@ -174,7 +174,7 @@ function matchSkills(skills: SkillInfo[], filters: string[]): SkillInfo[] {
   if (filters.length === 0) return skills
   const matched = skills.filter((skill) =>
     filters.some((filter) => {
-      const needle = filter.replace(/^sootsim-/, '').replace(/^rnx-/, '')
+      const needle = filter.replace(/^rnx-/, '')
       return (
         skill.name.includes(filter) || skill.name.replace(/^rnx-/, '').includes(needle)
       )

package/cli/commands/slides.ts

@@ -1,4 +1,4 @@
-// sootsim screenshot slides — drive the live screenshot-mode composition from the
+// rnx screenshot slides — drive the live screenshot-mode composition from the
 // terminal. same pipeline as the in-shell UI (rail/strip): every mutation
 // goes through the shell's screenshotControl bridge so the browser UI
 // reflects each step live, captures auto-upload, and exports are the

package/cli/commands/telemetry.ts

@@ -1,4 +1,4 @@
-// `sootsim config telemetry on|off` — retained as the command spelling for the
+// `rnx config telemetry on|off` — retained as the command spelling for the
 // product analytics preference shown by guided setup and Settings.
 //
 // this is the process-wide preference; `DO_NOT_TRACK=1` still forces opt-out

package/cli/commands/three-mode.ts

@@ -1,4 +1,4 @@
-// sootsim mode three — toggle the live browser 3d device stage.
+// rnx mode three — toggle the live browser 3d device stage.
 //
 // wraps the existing `toggle-three-mode` shell action so CLI, rail, and
 // menu all use the same plugin-owned state path.

package/cli/commands/timeline.ts

@@ -1,19 +1,19 @@
-// sootsim timeline — control the semantic agent-facing event log
+// rnx timeline — control the semantic agent-facing event log
 //
-// `sootsim record` is for video/screen capture; `sootsim debug record` is
+// `rnx record` is for video/screen capture; `rnx debug record` is
 // for the engine-internal debug-channel ring; this command is the third
 // surface and explicitly distinct: it manages SootSim.bridges.timeline,
 // the unified, agent-facing semantic event stream across host / shell
 // worker / tenant worker.
 //
 // usage:
-//   sootsim timeline status                      # what's enabled
-//   sootsim timeline start [kinds]               # enable kinds (default: opt-in defaults)
-//   sootsim timeline stop [kinds]                # disable kinds (or 'all')
-//   sootsim timeline clear                       # drop all events + cursors
-//   sootsim timeline dump <file>                 # write current ring to JSON
+//   rnx timeline status                      # what's enabled
+//   rnx timeline start [kinds]               # enable kinds (default: opt-in defaults)
+//   rnx timeline stop [kinds]                # disable kinds (or 'all')
+//   rnx timeline clear                       # drop all events + cursors
+//   rnx timeline dump <file>                 # write current ring to JSON
 //
-// see `sootsim what-happened` for the read side.
+// see `rnx what-happened` for the read side.
 
 import { writeFileSync } from 'fs'
 import { rnxExit } from '../run-rnx'