rnxsim 0.1.376 → 0.1.378

package/cli/commands/flow.ts

@@ -34,7 +34,7 @@ import {
 } from './control'
 import { printShellPerfReport } from './inspect'
 import { resolveDefaultUploadOrigin } from './upload'
-import type { SootSimConfig } from '../../src/config'
+import type { RNXConfig } from '../../src/config'
 import type { UploadResult } from './upload'
 
 export { parseFlowFile, validateFlowFile } from '../flow-file'
@@ -59,7 +59,7 @@ export function getLastFlowTraceSteps(): SootSimFlowTraceStep[] {
 // port and runtime config into the open command.
 export async function resolveAppFrontmatterTarget(
   raw: string,
-): Promise<{ target: string; runtimeConfig?: SootSimConfig }> {
+): Promise<{ target: string; runtimeConfig?: RNXConfig }> {
   if (!raw) return { target: '' }
   const trimmed = raw.trim()
   if (!trimmed) return { target: '' }
@@ -98,19 +98,19 @@ export async function runFlowPlayback(args: string[]): Promise<number> {
   lastFlowTraceSteps = []
   if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
     console.log(`
-sootsim maestro — author and run Maestro YAML flows
+rnx maestro — author and run Maestro YAML flows
 
 usage:
-  sootsim maestro test <flow.yaml> [options]
-  sootsim maestro start
-  sootsim maestro keep
-  sootsim maestro end [--output <path>] [--validate] [--video]
-  sootsim maestro validate <path>
+  rnx maestro test <flow.yaml> [options]
+  rnx maestro start
+  rnx maestro keep
+  rnx maestro end [--output <path>] [--validate] [--video]
+  rnx maestro validate <path>
 
 options:
   --record             record a webm artifact while the flow runs
   --profile            capture perf stats while the flow runs
-  --out <dir>          output directory (default: /tmp/sootsim-recordings)
+  --out <dir>          output directory (default: /tmp/rnx-recordings)
   --device <model>     override the flow frontmatter device for this run
   --slow <ms>          delay between steps for natural pacing
   --tail-wait <ms>     hold the recording open after the last step so the
@@ -161,15 +161,15 @@ default runtime:
   recording and profiling both run on the same bridge-backed path
 
 examples:
-  sootsim maestro test login.yaml
-  sootsim maestro test demo.yaml --url 8081 --record --slow 500 --out ./recordings
-  sootsim maestro test demo.yaml --sim a2
-  sootsim maestro start
-  sootsim maestro keep
-  sootsim maestro end --output ./.maestro/draft.yaml
-  sootsim maestro end --output ./.maestro/draft.yaml --validate
-  sootsim maestro end --output ./.maestro/draft.yaml --video
-  sootsim maestro validate ./.maestro/draft.yaml
+  rnx maestro test login.yaml
+  rnx maestro test demo.yaml --url 8081 --record --slow 500 --out ./recordings
+  rnx maestro test demo.yaml --sim a2
+  rnx maestro start
+  rnx maestro keep
+  rnx maestro end --output ./.maestro/draft.yaml
+  rnx maestro end --output ./.maestro/draft.yaml --validate
+  rnx maestro end --output ./.maestro/draft.yaml --video
+  rnx maestro validate ./.maestro/draft.yaml
 
 flow extension:
   takeScreenshot: hero
@@ -192,14 +192,14 @@ flow extension:
   // --headless (you asked to watch it run).
   const headed = args.includes('--headed')
   const openInNewSim = args.includes('--new') || headed
-  const outDir = getFlag('--out') || '/tmp/sootsim-recordings'
+  const outDir = getFlag('--out') || '/tmp/rnx-recordings'
   // when --screenshots isn't explicitly set, default to the --out directory.
   // this matches what most users expect: one flag controls the whole output
   // bundle (recording + screenshots) for a demo run.
-  // previously, screenshots silently landed in /tmp/sootsim-flow even when
+  // previously, screenshots silently landed in /tmp/rnx-flow even when
   // --out was set, requiring a second --screenshots flag to redirect them.
   const screenshotDir =
-    getFlag('--screenshots') || (getFlag('--out') ? outDir : '/tmp/sootsim-flow')
+    getFlag('--screenshots') || (getFlag('--out') ? outDir : '/tmp/rnx-flow')
   const screenshotPathMode =
     getFlag('--screenshot-paths') === 'flow' ? 'flow' : ('dir' as const)
   // --no-shell makes every takeScreenshot in the flow capture tenant-only
@@ -330,7 +330,7 @@ flow extension:
   const mode = wantElectron ? 'desktop companion' : 'bridge'
   const appLabel = targetApp ? ` | target: ${targetApp}` : ''
   console.log(`
-  sootsim maestro — ${path.basename(flowPath)}
+  rnx maestro — ${path.basename(flowPath)}
   ${steps.length} steps | ${mode}${appLabel}${record ? ' | recording' : ''}${profile ? ' | profiling' : ''}${slow ? ` | ${slow}ms delay` : ''}
 `)
 
@@ -427,7 +427,7 @@ flow extension:
       : readCurrentSimId() || resolvedBridgeArgs.simId
   // carry the source through so the target-sim notice reads `via --sim`
   // (not the misleading `primary fallback — no sim pinned`) when the flow
-  // was actually pinned with --sim or a `sootsim use` selection.
+  // was actually pinned with --sim or a `rnx use` selection.
   const pinnedSimIdSource: typeof resolvedBridgeArgs.simIdSource =
     resolvedBridgeArgs.simIdSource === 'flag' ? 'flag' : pinnedSimId ? 'saved' : 'none'
   const bridge = createBridge(resolvedBridgeArgs.wsPort, {
@@ -437,10 +437,10 @@ flow extension:
   })
   let driver: SootSimBridgeFlowRunner
   const applyFlowFrontmatter = async () => {
-    const statusBarTime = frontmatter.env?.SOOTSIM_STATUS_BAR_TIME
+    const statusBarTime = frontmatter.env?.RNX_STATUS_BAR_TIME
     if (statusBarTime) {
       if (!/^(?:[1-9]|1[0-2]):[0-5][0-9]$/.test(statusBarTime)) {
-        throw new Error('SOOTSIM_STATUS_BAR_TIME must be a 12-hour time such as 9:41')
+        throw new Error('RNX_STATUS_BAR_TIME must be a 12-hour time such as 9:41')
       }
       await bridge.send({
         type: 'evaluate',
@@ -480,7 +480,7 @@ flow extension:
     billingOriginOverride: preview ? previewOrigin : undefined,
     // any recording reached via a github installation token is a ci /
     // pr-preview run, so allow it for preview uploads. local flow recording
-    // writes a file and matches `sootsim record --mode video`.
+    // writes a file and matches `rnx record --mode video`.
     allowGitHubRecording: preview,
     requireRecordingEntitlement: preview,
     // re-arm the event recorder after every launchApp-with-reload. the
@@ -550,8 +550,8 @@ flow extension:
     // here is redundant and triggers a sim-id rotation on the reload that
     // routes the flow to a stale sim, hanging step 1 ("made no progress …
     // bridge or bundle probably hung"). one reset is enough — the bot
-    // signals it did one via SOOTSIM_PREVIEW_RESET_DONE.
-    if (preview && !startsWithLaunchApp && !process.env.SOOTSIM_PREVIEW_RESET_DONE) {
+    // signals it did one via RNX_PREVIEW_RESET_DONE.
+    if (preview && !startsWithLaunchApp && !process.env.RNX_PREVIEW_RESET_DONE) {
       await driver.launchApp({ clearState: true })
     }
     if (record) {
@@ -701,9 +701,9 @@ flow extension:
       )
     }
     await printBridgeFailureDiagnostics(bridge, {
-      errorsCommand: `sootsim get errors 5${driver.simId ? ` --sim ${driver.simId}` : ''}`,
-      warningsCommand: `sootsim get warnings 5${driver.simId ? ` --sim ${driver.simId}` : ''}`,
-      requestsCommand: `sootsim get requests 5${driver.simId ? ` --sim ${driver.simId}` : ''}`,
+      errorsCommand: `rnx get errors 5${driver.simId ? ` --sim ${driver.simId}` : ''}`,
+      warningsCommand: `rnx get warnings 5${driver.simId ? ` --sim ${driver.simId}` : ''}`,
+      requestsCommand: `rnx get requests 5${driver.simId ? ` --sim ${driver.simId}` : ''}`,
     })
     exitCode = 1
   }
@@ -795,7 +795,7 @@ flow extension:
   } else if (driver.simId && driver.simId !== pinnedSimId) {
     // `launchApp clearState` rotates the sim id mid-flow (the shell reconnects
     // under a fresh id). the runner tracks that in-memory, but a directory run
-    // (`sootsim maestro test <dir>`) spawns the next flow fresh — it re-reads
+    // (`rnx maestro test <dir>`) spawns the next flow fresh — it re-reads
     // the saved sim id, which would still point at the pre-rotation sim and
     // fail with "sim not responding / stale orphan". persist the rotated id so
     // the next flow reuses the live sim. only when we're NOT closing it.
@@ -847,7 +847,7 @@ async function prepareEventsFile(events: Array<Record<string, any>>): Promise<st
   const lines =
     events.map((e) => JSON.stringify(e)).join('\n') + (events.length ? '\n' : '')
   const gz = gzipSync(Buffer.from(lines, 'utf8'))
-  const outPath = path.join(tmpdir(), `sootsim-events-${Date.now()}.jsonl.gz`)
+  const outPath = path.join(tmpdir(), `rnx-events-${Date.now()}.jsonl.gz`)
   fs.writeFileSync(outPath, gz)
   console.log(`  events: ${events.length} written to ${outPath} (${gz.length} bytes gz)`)
   return outPath
@@ -878,7 +878,7 @@ async function prepareFlowStepTimelineFile(
   }))
   const lines = events.map((event) => JSON.stringify(event)).join('\n') + '\n'
   const gz = gzipSync(Buffer.from(lines, 'utf8'))
-  const outPath = path.join(tmpdir(), `sootsim-flow-steps-${Date.now()}.jsonl.gz`)
+  const outPath = path.join(tmpdir(), `rnx-flow-steps-${Date.now()}.jsonl.gz`)
   fs.writeFileSync(outPath, gz)
   console.log(
     `  flow trace: ${events.length} step events written to ${outPath} (${gz.length} bytes gz)`,
@@ -905,14 +905,14 @@ async function prepareFlowSnapshotManifest(
       : [],
   )
   if (snapshots.length === 0) return null
-  const outPath = path.join(tmpdir(), `sootsim-flow-snapshots-${Date.now()}.json`)
+  const outPath = path.join(tmpdir(), `rnx-flow-snapshots-${Date.now()}.json`)
   fs.writeFileSync(outPath, JSON.stringify(snapshots))
   console.log(`  flow snapshots: ${snapshots.length} written to ${outPath}`)
   return outPath
 }
 
 async function prepareFrameStatsFile(frameStats: unknown): Promise<string> {
-  const outPath = path.join(tmpdir(), `sootsim-frame-stats-${Date.now()}.json`)
+  const outPath = path.join(tmpdir(), `rnx-frame-stats-${Date.now()}.json`)
   fs.writeFileSync(outPath, JSON.stringify(frameStats))
   console.log(`  frame stats: written to ${outPath}`)
   return outPath
@@ -934,7 +934,7 @@ async function runFlowSession(args: string[]) {
     case 'keep': {
       const result = keepFlowCandidate()
       if (!result.active) {
-        console.error('  no active flow draft — run `sootsim maestro start` first')
+        console.error('  no active flow draft — run `rnx maestro start` first')
         rnxExit(1)
       }
       if (!result.kept) {
@@ -963,14 +963,14 @@ async function runFlowSession(args: string[]) {
         outputPath || (validate ? createDraftValidationPath() : undefined),
       )
       if (!result.active) {
-        console.error('  no active flow draft — run `sootsim maestro start` first')
+        console.error('  no active flow draft — run `rnx maestro start` first')
         rnxExit(1)
       }
       if (!result.valid) {
         console.error('  flow draft is not valid:')
         for (const issue of result.issues) console.error(`    - ${issue}`)
         console.error(
-          '  draft preserved — keep at least one real interaction or run `sootsim maestro start` to reset',
+          '  draft preserved — keep at least one real interaction or run `rnx maestro start` to reset',
         )
         rnxExit(1)
       }
@@ -1005,7 +1005,7 @@ async function runFlowSession(args: string[]) {
       )
       if (result.outputPath) {
         console.log(`  saved: ${result.outputPath}`)
-        console.log(`  next: sootsim maestro test ${result.outputPath} --record`)
+        console.log(`  next: rnx maestro test ${result.outputPath} --record`)
         return
       }
       console.log('')
@@ -1016,7 +1016,7 @@ async function runFlowSession(args: string[]) {
     case 'validate': {
       const flowPath = args[1]
       if (!flowPath || flowPath.startsWith('-')) {
-        console.error('  usage: sootsim maestro validate <path>')
+        console.error('  usage: rnx maestro validate <path>')
         rnxExit(1)
       }
       const issues = validateFlowFile(flowPath)
@@ -1033,7 +1033,7 @@ async function runFlowSession(args: string[]) {
 
 // the subcommand / flow-file path is the first positional arg, but a
 // `--sim <id>` pair can sit in front of it: bin.ts prepends the global
-// `--sim` to every command's args, and `sootsim maestro --sim a2 start` is a
+// `--sim` to every command's args, and `rnx maestro --sim a2 start` is a
 // documented form. hoist a leading `--sim <value>` to the end so `args[0]`
 // is the real subcommand again (downstream getFlag / parseBridgeCliArgs
 // still find `--sim` wherever it lands). without this, `--sim 6a5 flow
@@ -1071,7 +1071,7 @@ function printFlowProfile(result: SootSimFlowProfileResult) {
   printShellPerfReport(result)
 }
 function createDraftValidationPath() {
-  return path.join(tmpdir(), `sootsim-flow-draft-${Date.now()}.yaml`)
+  return path.join(tmpdir(), `rnx-flow-draft-${Date.now()}.yaml`)
 }
 
 function buildFlowValidationArgs(args: string[], outputPath: string | null) {

package/cli/commands/inspect/count.ts

@@ -1,4 +1,4 @@
-// `sootsim get count` — total SootSimNode count in the live tree.
+// `rnx get count` — total SootSimNode count in the live tree.
 
 import { inspectNodeCount } from './core'
 import { printJson, wantsJson } from './shared'

package/cli/commands/inspect/describe.ts

@@ -1,4 +1,4 @@
-// `sootsim describe` — format the pruned visible semantic tree.
+// `rnx describe` — format the pruned visible semantic tree.
 
 import { maybeHint } from '../../hints'
 import { inspectDescribe, type DescribeDumpOptions } from './core'

package/cli/commands/inspect/env.ts

@@ -3,7 +3,7 @@
 // budget and log more aggressively, because an agent can't see mid-animation
 // flicker the way a human can.
 const AGENT_ENV_VARS = [
-  'SOOTSIM_AGENT',
+  'RNX_AGENT',
   'TM_SESSION',
   'CLAUDECODE',
   'CLAUDE_CODE_ENTRYPOINT',
@@ -14,7 +14,7 @@ const AGENT_ENV_VARS = [
 ]
 
 export function isAgentEnv(): boolean {
-  if (process.env.SOOTSIM_AGENT === '0') return false
+  if (process.env.RNX_AGENT === '0') return false
   for (const name of AGENT_ENV_VARS) {
     const v = process.env[name]
     if (v && v.trim() && v !== '0') return true

package/cli/commands/inspect/get-layout.ts

@@ -1,4 +1,4 @@
-// `sootsim get-layout` — bounding boxes for visible meaningful elements on the
+// `rnx get-layout` — bounding boxes for visible meaningful elements on the
 // current screen. focused on the layout numbers a designer checks: on-screen
 // box (x/y/w/h). pass --styling for computed borderRadius, per-side padding,
 // fontSize, visual style fields, and native rendered text contrast. pass

package/cli/commands/inspect/keyboard.ts

@@ -1,4 +1,4 @@
-// `sootsim get keyboard` — prints the current iOS keyboard's full state.
+// `rnx get keyboard` — prints the current iOS keyboard's full state.
 //
 // shows visibility, keyboardType, returnKeyType, autoCapitalize policy,
 // active QWERTY sub-mode, shift + capsLock, and the mounted accessory bar

package/cli/commands/inspect/list.ts

@@ -1,4 +1,4 @@
-// `sootsim list` — connected sims, with the active one marked.
+// `rnx list` — connected sims, with the active one marked.
 
 import { printConnectedSims } from '../control'
 import { printJson, wantsJson } from './shared'

package/cli/commands/inspect/memory.ts

@@ -1,4 +1,4 @@
-// `sootsim get memory` / `sootsim debug memory` — per-worker live object
+// `rnx get memory` / `rnx debug memory` — per-worker live object
 // counts (nodes registered, pictures, raster images, paragraphs, yoga wasm
 // nodes), image-loader cache, and JS heaps. one-shot by default; --watch
 // samples repeatedly and reports per-counter slope, which is the leak-RCA

package/cli/commands/inspect/resolve-target.ts

@@ -6,7 +6,7 @@ import type { WsBridge } from '../../ws-bridge'
 //
 // pass `positional` from a verb whose positionals are x/y coordinates (tap,
 // double-tap, long-press) and a bare non-numeric first positional reads as a
-// testID: `sootsim do tap my-button` works like `do tap-id my-button` and like
+// testID: `rnx do tap my-button` works like `do tap-id my-button` and like
 // `do scroll <id>`, instead of failing with a usage line for the one verb an
 // agent is most likely to reach for. a coordinate is always numeric, so there
 // is nothing to disambiguate.

package/cli/commands/inspect/screens.ts

@@ -1,4 +1,4 @@
-// `sootsim get screens` — print the current navigation stack + shell state +
+// `rnx get screens` — print the current navigation stack + shell state +
 // any presented modal + keyboard. answers "what screen am I on?" without
 // having to dump the whole tree or scrape screen-specific testIDs.
 //

package/cli/commands/inspect/tree.ts

@@ -1,4 +1,4 @@
-// `sootsim get tree` — pruned structured semantic tree, default depth 5.
+// `rnx get tree` — pruned structured semantic tree, default depth 5.
 
 import { formatSemanticTree, inspectTree, isSimSemanticTree } from './core'
 import { printJson, wantsJson } from './shared'

package/cli/commands/inspect/url.ts

@@ -1,4 +1,4 @@
-// `sootsim get url` — prints the current page URL the bridge is attached to.
+// `rnx get url` — prints the current page URL the bridge is attached to.
 
 import { inspectUrl } from './core'
 import { printJson, wantsJson } from './shared'

package/cli/commands/inspect/wait-event.ts

@@ -1,10 +1,10 @@
-// sootsim wait event — block until a semantic timeline event of the
+// rnx wait event — block until a semantic timeline event of the
 // given kind appears, or timeout.
 //
 // usage:
-//   sootsim wait event <kind> [--max-ms 5000] [--since now|cursor]
-//   sootsim wait event fetch [--filter <substring>]
-//   sootsim wait event screen [--equals SignInPage]
+//   rnx wait event <kind> [--max-ms 5000] [--since now|cursor]
+//   rnx wait event fetch [--filter <substring>]
+//   rnx wait event screen [--equals SignInPage]
 //
 // the existing wait family is layout-driven: `wait selector` polls
 // for a testID, `wait idle` polls for rAF + animation settling,
@@ -111,7 +111,7 @@ function eventMatches(
 export async function runWaitEventSubcommand(opts: WaitEventOptions): Promise<void> {
   const { bridge, args, positional, inspectUsage } = opts
   // positional shape after verb-prefix strip and stripBooleanFlags:
-  //   sootsim wait event <kind>  →  ['event', '<kind>']
+  //   rnx wait event <kind>  →  ['event', '<kind>']
   // so positional[1] is the kind.
   const kind = positional[1]
   if (!kind) {

package/cli/commands/inspect.ts

@@ -499,7 +499,7 @@ function printRenderProfile(worker: string, rp: Record<string, any> | undefined)
 // pretty-print the shell frame profile payload (__sootsimShellPerf.stop()):
 // per-painted-frame timing from the shell worker merged with the render
 // profile counters. numbers arrive pre-rounded from the worker. also used by
-// `sootsim maestro test --profile`, which records the same payload.
+// `rnx maestro test --profile`, which records the same payload.
 export function printShellPerfReport(result: Record<string, any>) {
   const fps = result.avgMs > 0 ? (1000 / result.avgMs).toFixed(1) : '?'
   const jank = result.jank && typeof result.jank === 'object' ? result.jank : null
@@ -1021,9 +1021,9 @@ export async function runInspect(args: string[], opts: InspectOptions) {
   // strip a leading grouping verb — `get`, `do`, and (when forwarded from
   // runDebug) `debug`. these are organizational prefixes and shouldn't leak
   // into subcommand dispatch. e.g.:
-  //   sootsim get tree      → effectiveArgs = ['tree']
-  //   sootsim do tap 100 200 → effectiveArgs = ['tap', '100', '200']
-  //   sootsim debug state shell → effectiveArgs = ['state', 'shell']
+  //   rnx get tree      → effectiveArgs = ['tree']
+  //   rnx do tap 100 200 → effectiveArgs = ['tap', '100', '200']
+  //   rnx debug state shell → effectiveArgs = ['state', 'shell']
   const verbPrefix =
     args[0] === 'get' || args[0] === 'do' || args[0] === 'debug' || args[0] === 'wait'
       ? args[0]
@@ -1113,7 +1113,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
 
   if (!subcommand || args.includes('--help') || args.includes('-h')) {
     // all help output comes from the registry in packages/sootsim-skills
-    // so `sootsim do --help`, `sootsim get --help`, the website docs, and
+    // so `rnx do --help`, `rnx get --help`, the website docs, and
     // the Contrast skill markdown stay in lock-step. a drift check in
     // test/sootsimCliRegistry.test.ts fails CI if a verb lands without a
     // matching registry entry.
@@ -1182,7 +1182,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
     return
   }
 
-  // `sootsim list --drivers` — pure local registry view, no bridge needed.
+  // `rnx list --drivers` — pure local registry view, no bridge needed.
   // short-circuit here so users can discover drivers even when no sootsim
   // session is running.
   if (
@@ -1730,9 +1730,9 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       }
 
       case 'event': {
-        // sootsim wait event <kind> — timeline-backed wait. delegates
+        // rnx wait event <kind> — timeline-backed wait. delegates
         // matcher + polling to runWaitEventSubcommand so the same
-        // logic is reachable from `sootsim wait event` regardless of
+        // logic is reachable from `rnx wait event` regardless of
         // verb-group prefix (and the same shape is testable on its
         // own).
         await runWaitEventSubcommand({ bridge, args, positional, inspectUsage })
@@ -1741,7 +1741,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
 
       case 'layout': {
         const id = positional[1]
-        // bare `sootsim get layout` (no id) measures visible elements on the
+        // bare `rnx get layout` (no id) measures visible elements on the
         // screen by bounding box. --styling opts into box-model/style detail via
         // the shared get-layout kernel the agent's app_get_layout also uses.
         // passing an id keeps the single-node {x, y, width, height} lookup.
@@ -1777,7 +1777,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       case 'capture':
       case 'screenshot': {
         const outputArg = args.find((_, i) => args[i - 1] === '--output')
-        const outputPath = outputArg || '/tmp/sootsim-inspect.png'
+        const outputPath = outputArg || '/tmp/rnx-inspect.png'
         const rect = await resolveSampleRect(args, bridge)
 
         const request: { type: 'screenshot'; crop?: SampleRect } = { type: 'screenshot' }
@@ -2275,7 +2275,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       }
 
       case 'tap-best': {
-        // sootsim do tap-best <query> — try tap-id, then tap-text. the
+        // rnx do tap-best <query> — try tap-id, then tap-text. the
         // common agent ergonomic problem: the agent has a label like
         // "Create expense" and doesn't know whether that's a testID
         // or visible text. with tap-text it fails when the only
@@ -2980,8 +2980,8 @@ export async function runInspect(args: string[], opts: InspectOptions) {
 
       case 'state': {
         const stateCmd = positional[1]
-        // `sootsim get state` (no sub-arg) → compact runtime dashboard.
-        // `sootsim debug state <kind>` continues to dispatch the raw dumps.
+        // `rnx get state` (no sub-arg) → compact runtime dashboard.
+        // `rnx debug state <kind>` continues to dispatch the raw dumps.
         if (verbPrefix === 'get' && !stateCmd) {
           const base = await callTestBridge<Record<string, any>>(
             bridge,
@@ -4171,20 +4171,20 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       }
 
       case 'network': {
-        // sootsim network — live request inspector backed by the shared
+        // rnx network — live request inspector backed by the shared
         // observability store (installed at engine boot, fed by worker-side
         // fetch + XHR capture over BroadcastChannel).
         //
         // shapes:
-        //   sootsim network [limit]             last N entries (default 20)
-        //   sootsim network --failed            only non-2xx / errored
-        //   sootsim network --slow              only requests slower than --threshold (default 1000ms)
-        //   sootsim network --threshold <ms>    customize slow threshold for --slow
-        //   sootsim network --filter <substring> url substring filter
-        //   sootsim network --json              raw json output
-        //   sootsim network tail | -f           follow mode (polls)
-        //   sootsim network get <id>            detail for one entry
-        //   sootsim network clear               drop the buffer
+        //   rnx network [limit]             last N entries (default 20)
+        //   rnx network --failed            only non-2xx / errored
+        //   rnx network --slow              only requests slower than --threshold (default 1000ms)
+        //   rnx network --threshold <ms>    customize slow threshold for --slow
+        //   rnx network --filter <substring> url substring filter
+        //   rnx network --json              raw json output
+        //   rnx network tail | -f           follow mode (polls)
+        //   rnx network get <id>            detail for one entry
+        //   rnx network clear               drop the buffer
         const sub = positional[1]
 
         // manual flag scan — parseBridgeCliArgs already stripped these
@@ -4364,17 +4364,17 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       }
 
       case 'logs': {
-        // sootsim logs — live console inspector backed by the shared
+        // rnx logs — live console inspector backed by the shared
         // observability log store (fed by worker-side console capture over
-        // BroadcastChannel). mirrors `sootsim network`:
+        // BroadcastChannel). mirrors `rnx network`:
         //
-        //   sootsim logs [limit]            last N entries (default 50)
-        //   sootsim logs --level error,warn filter by level (csv)
-        //   sootsim logs --filter <str>     message substring filter
-        //   sootsim logs --internal         include engine-internal [sootsim] logs (hidden by default)
-        //   sootsim logs --json             raw json output
-        //   sootsim logs tail | -f          follow mode (polls)
-        //   sootsim logs clear              drop the buffer
+        //   rnx logs [limit]            last N entries (default 50)
+        //   rnx logs --level error,warn filter by level (csv)
+        //   rnx logs --filter <str>     message substring filter
+        //   rnx logs --internal         include engine-internal [sootsim] logs (hidden by default)
+        //   rnx logs --json             raw json output
+        //   rnx logs tail | -f          follow mode (polls)
+        //   rnx logs clear              drop the buffer
         const sub = positional[1]
 
         let filter: string | null = null
@@ -4493,11 +4493,11 @@ export async function runInspect(args: string[], opts: InspectOptions) {
     // auto-settle after any write command so the next CLI call doesn't see
     // mid-transition state. short deadline — if the app has a perpetual
     // background animation, we bail to layout-only stability via the same
-    // logic `do settle` uses. opt-out: --no-wait or SOOTSIM_NO_AUTO_WAIT=1.
+    // logic `do settle` uses. opt-out: --no-wait or RNX_NO_AUTO_WAIT=1.
     if (
       writeCommands.has(subcommand) &&
       !args.includes('--no-wait') &&
-      process.env.SOOTSIM_NO_AUTO_WAIT !== '1' &&
+      process.env.RNX_NO_AUTO_WAIT !== '1' &&
       !(await shouldSkipAutoSettleForInspectPick(bridge, subcommand))
     ) {
       await autoSettleAfterWrite(bridge)

package/cli/commands/install-desktop.ts

@@ -160,7 +160,7 @@ async function installMacDmg(dmgPath: string): Promise<string> {
   const userApps = resolve(process.env.HOME || '', 'Applications')
   let destRoot = systemApps
   try {
-    const probe = join(systemApps, `.sootsim-write-probe-${process.pid}`)
+    const probe = join(systemApps, `.rnx-write-probe-${process.pid}`)
     spawnSync('touch', [probe])
     if (existsSync(probe)) rmSync(probe, { force: true })
     else destRoot = userApps
@@ -281,7 +281,7 @@ examples:
   const skipConfirm =
     args.includes('--yes') ||
     args.includes('-y') ||
-    process.env.SOOTSIM_NO_PROMPT === '1' ||
+    process.env.RNX_NO_PROMPT === '1' ||
     process.env.CI === '1' ||
     !process.stdin.isTTY
   const force = args.includes('--force')
@@ -318,7 +318,7 @@ examples:
     console.log()
   }
 
-  const workDir = join(tmpdir(), `sootsim-install-${Date.now()}`)
+  const workDir = join(tmpdir(), `rnx-install-${Date.now()}`)
   const downloadPath = join(workDir, target.filename)
 
   let lastDraw = 0

package/cli/commands/login.ts

@@ -8,7 +8,7 @@ import {
 import { rnxPublicBrand } from '../../src/public-brand'
 import { rnxExit } from '../run-rnx'
 
-const REMOTE_DEFAULT_ORIGIN = process.env.SOOTSIM_AUTH_ORIGIN || 'https://contrast.dev'
+const REMOTE_DEFAULT_ORIGIN = process.env.RNX_AUTH_ORIGIN || 'https://contrast.dev'
 
 type LoginResult =
   | { ok: true; token: string; userId?: string; email?: string }
@@ -16,8 +16,8 @@ type LoginResult =
 
 function resolveDefaultAuthOrigin(explicitOrigin?: string) {
   if (explicitOrigin) return explicitOrigin
-  if (process.env.SOOTSIM_AUTH_ORIGIN) return process.env.SOOTSIM_AUTH_ORIGIN
-  if (process.env.SOOTSIM_UPLOAD_ORIGIN) return process.env.SOOTSIM_UPLOAD_ORIGIN
+  if (process.env.RNX_AUTH_ORIGIN) return process.env.RNX_AUTH_ORIGIN
+  if (process.env.RNX_UPLOAD_ORIGIN) return process.env.RNX_UPLOAD_ORIGIN
   return REMOTE_DEFAULT_ORIGIN
 }
 
@@ -30,7 +30,7 @@ usage:
 
 options:
   --origin <url>     auth host (default: ${REMOTE_DEFAULT_ORIGIN})
-                     override with SOOTSIM_AUTH_ORIGIN env var
+                     override with RNX_AUTH_ORIGIN env var
   -h, --help
 `)
 }
@@ -114,7 +114,7 @@ function isLocalOrigin(origin: string): boolean {
     if (hostname.endsWith('.local')) return true
     if (hostname.endsWith('.localhost')) return true
     // VM↔host bridge aliases — orb, docker, lima, multipass all forward the
-    // host on a well-known name (IPv4 or IPv6) so a VM-internal `sootsim login`
+    // host on a well-known name (IPv4 or IPv6) so a VM-internal `rnx login`
     // can still take the dev-login fast path against the host's Contrast dev
     // server. without this the CLI falls through to a browser callback that
     // is unreachable from a headless VM.
@@ -253,7 +253,7 @@ export async function runLogin(args: string[]) {
         return
       }
 
-      const url = new URL(`${origin.replace(/\/$/, '')}/auth/sootsim-cli`)
+      const url = new URL(`${origin.replace(/\/$/, '')}/auth/rnx-cli`)
       url.searchParams.set('state', state)
       url.searchParams.set('port', String(address.port))
       url.searchParams.set('contrast', origin)