peachsim 0.1.571 → 0.1.573

package/cli/commands/slides.ts

@@ -1,4 +1,4 @@
-// rnx screenshot slides — drive the live screenshot-mode composition from the
+// peach 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
@@ -16,18 +16,18 @@ import {
 } from '../ws-bridge'
 
 const HELP = `
-rnx screenshot slides — compose App Store screenshots in the live sim
+peach screenshot slides — compose App Store screenshots in the live sim
 
 usage:
-  rnx screenshot slides                       list slides (alias: slides list)
-  rnx screenshot slides set <n> [fields]      patch a slide's copy/colors
-  rnx screenshot slides add                   append a blank slide (focuses it)
-  rnx screenshot slides remove <n>            delete a slide
-  rnx screenshot slides move <n> <position>   reorder a slide
-  rnx screenshot slides focus <n>             open a slide (device flips into it)
-  rnx screenshot slides overview              back to the gallery
-  rnx screenshot slides capture [<n>]         capture the live frame into a slide
-  rnx screenshot slides export [<n>] [--out <dir>]
+  peach screenshot slides                       list slides (alias: slides list)
+  peach screenshot slides set <n> [fields]      patch a slide's copy/colors
+  peach screenshot slides add                   append a blank slide (focuses it)
+  peach screenshot slides remove <n>            delete a slide
+  peach screenshot slides move <n> <position>   reorder a slide
+  peach screenshot slides focus <n>             open a slide (device flips into it)
+  peach screenshot slides overview              back to the gallery
+  peach screenshot slides capture [<n>]         capture the live frame into a slide
+  peach screenshot slides export [<n>] [--out <dir>]
                                                   write composed App-Store PNG(s)
 
 set fields:
@@ -43,12 +43,12 @@ set fields:
 notes:
   slides are addressed by 1-based index. screenshot mode is auto-enabled.
   capture shoots whatever the sim currently shows — navigate the app first
-  (rnx do tap-id …), then capture.
+  (peach do tap-id …), then capture.
 
 examples:
-  rnx screenshot slides set 1 --title "The ultimate MMA community." --bg-top cyan --bg-bottom black
-  rnx screenshot slides capture 1
-  rnx screenshot slides export --out ./exports
+  peach screenshot slides set 1 --title "The ultimate MMA community." --bg-top cyan --bg-bottom black
+  peach screenshot slides capture 1
+  peach screenshot slides export --out ./exports
 `
 
 interface SlideRow {
@@ -220,7 +220,7 @@ export async function runSlides(
       }
       case 'set': {
         if (refArg == null)
-          throw new Error('usage: rnx screenshot slides set <n> --title … (see --help)')
+          throw new Error('usage: peach screenshot slides set <n> --title … (see --help)')
         const patch: Record<string, string> = {}
         for (const key of [
           'title',
@@ -257,7 +257,7 @@ export async function runSlides(
         break
       }
       case 'remove': {
-        if (refArg == null) throw new Error('usage: rnx screenshot slides remove <n>')
+        if (refArg == null) throw new Error('usage: peach screenshot slides remove <n>')
         emit(
           await callInBridgeWrite<ControlState>(
             bridge,
@@ -269,7 +269,7 @@ export async function runSlides(
       }
       case 'move': {
         if (refArg == null || !Number.isInteger(positionArg) || positionArg < 1) {
-          throw new Error('usage: rnx screenshot slides move <n> <position>')
+          throw new Error('usage: peach screenshot slides move <n> <position>')
         }
         emit(
           await callInBridgeWrite<ControlState>(
@@ -282,7 +282,7 @@ export async function runSlides(
         break
       }
       case 'focus': {
-        if (refArg == null) throw new Error('usage: rnx screenshot slides focus <n>')
+        if (refArg == null) throw new Error('usage: peach screenshot slides focus <n>')
         emit(
           await callInBridgeWrite<ControlState>(
             bridge,
@@ -349,7 +349,7 @@ export async function runSlides(
         break
       }
       default:
-        throw new Error(`unknown subcommand "${sub}" — see rnx screenshot slides --help`)
+        throw new Error(`unknown subcommand "${sub}" — see peach screenshot slides --help`)
     }
   } finally {
     bridge.close()

package/cli/commands/state.ts

@@ -19,10 +19,10 @@ function isSimStateResult(value: unknown): value is SimStateResult {
 
 function printHelp(): void {
   console.log(`
-rnx state - capture the current app state in one call
+peach state - capture the current app state in one call
 
 usage:
-  rnx state [--json] [--sim <id>]
+  peach state [--json] [--sim <id>]
 
 options:
   --json      print the complete structured result, including the screenshot

package/cli/commands/storage.ts

@@ -23,11 +23,11 @@ function findSubcommand(args: string[]): { name: string; index: number } | null
 
 function printHelp(): void {
   console.log(`
-rnx storage — manage sim and app storage
+peach storage — manage sim and app storage
 
 usage:
-  rnx storage profile <subcommand>
-  rnx storage clear [--full] [--sim <id>] [--json]
+  peach storage profile <subcommand>
+  peach storage clear [--full] [--sim <id>] [--json]
 
 subcommands:
   profile list

package/cli/commands/telemetry.ts

@@ -1,4 +1,4 @@
-// `rnx config telemetry on|off` — retained as the command spelling for the
+// `peach 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
@@ -49,7 +49,7 @@ export async function runTelemetry(args: string[]): Promise<void> {
 
     default:
       console.error(`  unknown telemetry action: ${sub}`)
-      console.error('  usage: rnx config telemetry [on|off|status]')
+      console.error('  usage: peach config telemetry [on|off|status]')
       rnxExit(1)
   }
 }

package/cli/commands/test.ts

@@ -1,4 +1,4 @@
-// rnx test — choose Maestro or Detox, support local bundle loopback and standalone cloud execution.
+// peach test — choose Maestro or Detox, support local bundle loopback and standalone cloud execution.
 
 import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
 import { createServer, type Server } from 'node:http'
@@ -32,7 +32,7 @@ interface TestAppTarget {
 }
 
 // every flag that swallows the token after it, so the positional scan finds
-// the flow/suite target no matter where the flags sit (`rnx test
+// the flow/suite target no matter where the flags sit (`peach test
 // --include-tags smoke .maestro/` must not take `smoke` as the target).
 // maestro compat flags live here alongside the flow-runner vocabulary;
 // without them a flag-first maestro command line mis-resolves its target.
@@ -256,7 +256,7 @@ function withoutApp(args: string[]): string[] {
   return result
 }
 
-// the maestro runner reads the app target as --url; rnx test spells it
+// the maestro runner reads the app target as --url; peach test spells it
 // --app/--bundle/--bundle-url. map each spelling explicitly: a prefix
 // replace would turn --bundle-url into --url-url.
 function mapAppFlagToUrl(arg: string): string {
@@ -332,9 +332,9 @@ export async function resolveTestAppTarget(app: string): Promise<TestAppTarget>
 
 function restoreRnxUrl(previous: string | undefined): void {
   if (previous === undefined) {
-    delete process.env.RNX_URL
+    delete process.env.PEACH_URL
   } else {
-    process.env.RNX_URL = previous
+    process.env.PEACH_URL = previous
   }
 }
 
@@ -358,7 +358,7 @@ export function resolveTestCommand(args: string[], cwd = process.cwd()) {
   // so reading only argv[0] breaks the exact pasted command line.
   let target = targetFromArgs(forwarded) ?? undefined
   if (!target && maestroConfig) {
-    // `rnx test --config e2e/config.yaml`: the config describes a workspace,
+    // `peach test --config e2e/config.yaml`: the config describes a workspace,
     // so run the directory it lives in.
     target = dirname(resolve(cwd, valueAfter(forwarded, '--config') as string))
   }
@@ -531,7 +531,7 @@ function collectTestFiles(
         const entryKey = keys[0] as string
         const glob = entryKey.replace(/[\\*?[\]{}()!+@]/g, '\\$&')
         files['config.yaml'] =
-          '# synthesized by rnx test --cloud: run exactly the submitted entry flow.\n' +
+          '# synthesized by peach test --cloud: run exactly the submitted entry flow.\n' +
           `flows:\n  - ${JSON.stringify(glob)}\n`
       }
     }
@@ -572,7 +572,7 @@ async function readJobStatus(
 export async function cancelCloudTest(jobId: string, origin: string): Promise<number> {
   const auth = resolveCliAuth()
   if (!auth) {
-    console.error('  error: cancelling a cloud test requires `rnx login` or RNX_API_KEY')
+    console.error('  error: cancelling a cloud test requires `peach login` or PEACH_API_KEY')
     return 1
   }
   const endpoint = `${origin.replace(/\/$/, '')}/api/sootsim/runner/jobs?id=${encodeURIComponent(jobId)}`
@@ -641,7 +641,7 @@ export async function runCloudTest(
   const cancelId = valueAfter(forwarded, '--cancel')
   if (forwarded.includes('--cancel') || cancelId !== null) {
     if (!cancelId) {
-      console.error('  usage: rnx test --cancel <job-id>')
+      console.error('  usage: peach test --cancel <job-id>')
       return 1
     }
     return cancelCloudTest(cancelId, origin)
@@ -676,7 +676,7 @@ export async function runCloudTest(
     }
   }
   if (!target) {
-    console.error('  usage: rnx test <flow-or-suite> --app <bundle> --cloud')
+    console.error('  usage: peach test <flow-or-suite> --app <bundle> --cloud')
     return 1
   }
 
@@ -688,7 +688,7 @@ export async function runCloudTest(
 
   if (!app) {
     console.error(
-      '  error: rnx test --cloud requires --app <bundle.js|https://bundle-url|http://localhost:port>',
+      '  error: peach test --cloud requires --app <bundle.js|https://bundle-url|http://localhost:port>',
     )
     return 1
   }
@@ -723,7 +723,7 @@ export async function runCloudTest(
 
   const auth = resolveCliAuth()
   if (!auth) {
-    console.error('  error: rnx test --cloud requires `rnx login` or RNX_API_KEY')
+    console.error('  error: peach test --cloud requires `peach login` or PEACH_API_KEY')
     return 1
   }
 
@@ -977,7 +977,7 @@ export async function runTest(
       const { flowTimeoutScale } = await import('../../src/flow-timeout-scale')
       if (flowTimeoutScale() !== 1) {
         throw new Error(
-          'rnx test requires original flow timeouts; unset SOOTSIM_FLOW_TIMEOUT_SCALE',
+          'peach test requires original flow timeouts; unset SOOTSIM_FLOW_TIMEOUT_SCALE',
         )
       }
       const { runMaestro } = await import('./maestro')
@@ -995,9 +995,9 @@ export async function runTest(
 
     const { runDetox } = await import('./detox')
     const detoxArgs = withoutApp(selected.args)
-    const previousRnxUrl = process.env.RNX_URL
+    const previousRnxUrl = process.env.PEACH_URL
     if (appTarget.target) {
-      process.env.RNX_URL = await buildShellUrl(
+      process.env.PEACH_URL = await buildShellUrl(
         appTarget.target,
         resolveShellBaseUrlForBridgePort(
           opts.port ?? (Number(process.env.SOOTSIM_PORT) || 5173),

package/cli/commands/three-mode.ts

@@ -1,4 +1,4 @@
-// rnx mode three — toggle the live browser 3d device stage.
+// peach 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.
@@ -35,16 +35,16 @@ const TIMELINE_ACTIONS = new Set(['load', 'seek', 'play', 'pause', 'render', 'me
 export async function runThreeMode(args: string[], opts: ShellBooleanModeOptions) {
   if (args.includes('--help') || args.includes('-h')) {
     console.log(`
-rnx mode three — toggle the 3d device stage
+peach mode three — toggle the 3d device stage
 
 usage:
-  rnx mode three [on|off|toggle]
-  rnx mode three configure [options]
-  rnx mode three load <timeline.json>
-  rnx mode three seek <time-ms>
-  rnx mode three play|pause
-  rnx mode three render <timeline.json> --output <dir> [options]
-  rnx mode three measure <timeline.json> [options]
+  peach mode three [on|off|toggle]
+  peach mode three configure [options]
+  peach mode three load <timeline.json>
+  peach mode three seek <time-ms>
+  peach mode three play|pause
+  peach mode three render <timeline.json> --output <dir> [options]
+  peach mode three measure <timeline.json> [options]
 
 arguments:
   on        enable 3d mode
@@ -98,13 +98,13 @@ measure options (projected bounds only — no pixels rendered):
   --output <file.json>   write the measurement JSON here instead of stdout
 
 examples:
-  rnx mode three
-  rnx mode three on
-  rnx mode three configure --script hero-arc --background gradient-tide
-  rnx mode three configure --environment on --env-shape pane --setting room
-  rnx mode three render ./cinematic.json --output ./frames --fps 30
-  rnx mode three measure ./cinematic.json --width 450 --height 900 --at 0,1200
-  rnx mode three off
+  peach mode three
+  peach mode three on
+  peach mode three configure --script hero-arc --background gradient-tide
+  peach mode three configure --environment on --env-shape pane --setting room
+  peach mode three render ./cinematic.json --output ./frames --fps 30
+  peach mode three measure ./cinematic.json --width 450 --height 900 --at 0,1200
+  peach mode three off
 `)
     rnxExit(0)
   }
@@ -243,7 +243,7 @@ export async function waitForThreeModeRuntimeReadyOnBridge(bridge: WsBridge) {
 
   if (state?.ready === true) return state
   if (state?.disabled) {
-    throw new Error('3d mode is off; run `rnx mode three on` before configure')
+    throw new Error('3d mode is off; run `peach mode three on` before configure')
   }
   throw new Error('3d mode runtime did not become ready')
 }

package/cli/commands/timeline.ts

@@ -1,19 +1,19 @@
-// rnx timeline — control the semantic agent-facing event log
+// peach timeline — control the semantic agent-facing event log
 //
-// `rnx record` is for video/screen capture; `rnx debug record` is
+// `peach record` is for video/screen capture; `peach debug record` is
 // for the engine-internal debug-channel ring; this command is the third
 // surface and explicitly distinct: it manages the SootSim.bridges.timeline API,
 // the unified, agent-facing semantic event stream across host / shell
 // worker / tenant worker.
 //
 // usage:
-//   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
+//   peach timeline status                      # what's enabled
+//   peach timeline start [kinds]               # enable kinds (default: opt-in defaults)
+//   peach timeline stop [kinds]                # disable kinds (or 'all')
+//   peach timeline clear                       # drop all events + cursors
+//   peach timeline dump <file>                 # write current ring to JSON
 //
-// see `rnx what-happened` for the read side.
+// see `peach what-happened` for the read side.
 
 import { writeFileSync } from 'fs'
 import { rnxExit } from '../run-rnx'
@@ -26,10 +26,10 @@ interface TimelineOptions {
 
 function printHelp() {
   console.log(`
-rnx timeline — control the semantic event timeline
+peach timeline — control the semantic event timeline
 
 usage:
-  rnx timeline <subcommand> [args]
+  peach timeline <subcommand> [args]
 
 subcommands:
   status                  show enabled kinds and ring sizes
@@ -43,7 +43,7 @@ toast, notification, route, shell, actionsheet, picker) record at all times.
 start/stop enables opt-in kinds (react-commit, scroll, gesture, text-input,
 layout, reanimated, animation).
 
-read the timeline with: rnx what-happened
+read the timeline with: peach what-happened
 `)
 }
 
@@ -97,7 +97,7 @@ export async function runTimeline(args: string[], opts: TimelineOptions) {
       case 'dump': {
         const outPath = rest[0]
         if (!outPath) {
-          console.error('  usage: rnx timeline dump <file>')
+          console.error('  usage: peach timeline dump <file>')
           rnxExit(1)
         }
         const result = await callInBridge<{ events: unknown[] }>(

package/cli/commands/upgrade.ts

@@ -1,4 +1,4 @@
-// rnx upgrade updates the separately delivered runtime first, then atomically
+// peach upgrade updates the separately delivered runtime first, then atomically
 // replaces the standalone cli executable. runtime stays first because replacing
 // the running cli's files before later dynamic imports can strand the command.
 
@@ -36,7 +36,7 @@ export async function runUpgrade(
   const channel =
     channelIdx >= 0 && args[channelIdx + 1] ? args[channelIdx + 1] : undefined
 
-  console.log('rnx upgrade\n')
+  console.log('peach upgrade\n')
 
   console.log('runtime:')
   const beforeRuntime = readActiveRuntime()
@@ -94,7 +94,7 @@ export async function upgradeCli(options: UpgradeOptions = {}): Promise<void> {
       return
     }
     throw new Error(
-      'this is not the standalone rnx executable; reinstall from https://rnxsim.com/install.sh',
+      'this is not the standalone peach executable; reinstall from https://peachsim.com/install.sh',
     )
   }
 
@@ -115,7 +115,7 @@ export async function upgradeCli(options: UpgradeOptions = {}): Promise<void> {
     .toString('utf8')
     .trim()
   if (!SHA256_PATTERN.test(expectedSha)) {
-    throw new Error('rnx update service returned an invalid executable checksum')
+    throw new Error('peach update service returned an invalid executable checksum')
   }
 
   console.log(`  v${current} → v${latest}`)
@@ -124,12 +124,12 @@ export async function upgradeCli(options: UpgradeOptions = {}): Promise<void> {
   const actualSha = createHash('sha256').update(executable).digest('hex')
   if (actualSha !== expectedSha) {
     throw new Error(
-      `downloaded rnx executable failed verification (expected ${expectedSha}, got ${actualSha})`,
+      `downloaded peach executable failed verification (expected ${expectedSha}, got ${actualSha})`,
     )
   }
 
   const executablePath = path.resolve(options.cliExecutablePath ?? process.execPath)
-  const tempDir = fs.mkdtempSync(path.join(path.dirname(executablePath), '.rnx-update-'))
+  const tempDir = fs.mkdtempSync(path.join(path.dirname(executablePath), '.peach-update-'))
   const candidatePath = path.join(tempDir, path.basename(executablePath))
   try {
     fs.writeFileSync(candidatePath, executable, { mode: 0o755 })
@@ -145,12 +145,12 @@ export async function upgradeCli(options: UpgradeOptions = {}): Promise<void> {
 function cliArtifactName(): string {
   const platform = process.platform === 'darwin' ? 'darwin' : process.platform
   if (platform !== 'darwin' && platform !== 'linux') {
-    throw new Error('standalone rnx self-update currently supports macOS and Linux')
+    throw new Error('standalone peach self-update currently supports macOS and Linux')
   }
   if (process.arch !== 'arm64' && process.arch !== 'x64') {
-    throw new Error(`standalone rnx does not support ${process.arch}`)
+    throw new Error(`standalone peach does not support ${process.arch}`)
   }
-  return `rnx-${platform}-${process.arch}`
+  return `peach-${platform}-${process.arch}`
 }
 
 function verifyCandidate(candidatePath: string, expectedVersion: string): void {
@@ -158,10 +158,10 @@ function verifyCandidate(candidatePath: string, expectedVersion: string): void {
     encoding: 'utf8',
     timeout: 15_000,
   })
-  const reported = result.stdout.match(/^rnx v([^\s]+)/m)?.[1]
+  const reported = result.stdout.match(/^peach v([^\s]+)/m)?.[1]
   if (result.status !== 0 || reported !== expectedVersion) {
     throw new Error(
-      `downloaded rnx executable reported ${reported ? `v${reported}` : 'no version'}; expected v${expectedVersion}`,
+      `downloaded peach executable reported ${reported ? `v${reported}` : 'no version'}; expected v${expectedVersion}`,
     )
   }
 }

package/cli/commands/upload.ts

@@ -1,5 +1,5 @@
-// rnx record upload — capture the currently-loaded bundle + device spec from
-// a running rnx sim and POST it to the Contrast upload endpoint. returns a
+// peach record upload — capture the currently-loaded bundle + device spec from
+// a running peach sim and POST it to the Contrast upload endpoint. returns a
 // /preview/<id> url that anyone can open to load this bundle in a frame.
 //
 // uploads are unlisted-public (unguessable id) but require a signed-in
@@ -113,16 +113,16 @@ function readSnapshotManifest(manifestPath: string): AttachedInteractionSnapshot
   })
 }
 
-const REMOTE_DEFAULT_ORIGIN = process.env.RNX_UPLOAD_ORIGIN || 'https://contrast.dev'
+const REMOTE_DEFAULT_ORIGIN = process.env.PEACH_UPLOAD_ORIGIN || 'https://contrast.dev'
 // the canonical public preview link. Uploads go to the contrast backend, but
 // reviewers/users open rnx preview pages on rnxsim.com.
 const REMOTE_DEFAULT_PUBLIC_PREVIEW_ORIGIN =
-  process.env.RNX_PREVIEW_ORIGIN || rnxPublicBrand.origin
+  process.env.PEACH_PREVIEW_ORIGIN || rnxPublicBrand.origin
 export async function resolveDefaultUploadOrigin(
   explicitOrigin?: string,
 ): Promise<string> {
   if (explicitOrigin) return explicitOrigin
-  if (process.env.RNX_UPLOAD_ORIGIN) return process.env.RNX_UPLOAD_ORIGIN
+  if (process.env.PEACH_UPLOAD_ORIGIN) return process.env.PEACH_UPLOAD_ORIGIN
   return REMOTE_DEFAULT_ORIGIN
 }
 
@@ -160,8 +160,8 @@ export function resolvePublicPreviewOrigin(
   explicitOrigin?: string,
 ): string {
   if (explicitOrigin) return normalizeOrigin(explicitOrigin)
-  if (process.env.RNX_PREVIEW_ORIGIN) {
-    return normalizeOrigin(process.env.RNX_PREVIEW_ORIGIN)
+  if (process.env.PEACH_PREVIEW_ORIGIN) {
+    return normalizeOrigin(process.env.PEACH_PREVIEW_ORIGIN)
   }
   if (isLoopbackOrigin(uploadOrigin)) return normalizeOrigin(uploadOrigin)
   if (isContrastOrigin(uploadOrigin)) {
@@ -172,18 +172,18 @@ export function resolvePublicPreviewOrigin(
 
 function printHelp() {
   console.log(`
-rnx record upload — publish the current recorded bundle as a /preview/<id> link
+peach record upload — publish the current recorded bundle as a /preview/<id> link
 
 usage:
-  rnx record upload [--origin <url>] [--public-origin <url>] (--events <path> | --video <path>) [--screenshot <path>] [--owner <org> --repo <repo>] [--sim <sim>] [--open] [--assets-only]
+  peach record upload [--origin <url>] [--public-origin <url>] (--events <path> | --video <path>) [--screenshot <path>] [--owner <org> --repo <repo>] [--sim <sim>] [--open] [--assets-only]
 
 options:
   --origin <url>     upload target (default: ${REMOTE_DEFAULT_ORIGIN})
-                     override with RNX_UPLOAD_ORIGIN env var
+                     override with PEACH_UPLOAD_ORIGIN env var
   --public-origin <url>
                      public /preview link origin (default: ${REMOTE_DEFAULT_PUBLIC_PREVIEW_ORIGIN}
                      for prod uploads, upload origin for localhost/custom origins).
-                     override with RNX_PREVIEW_ORIGIN env var
+                     override with PEACH_PREVIEW_ORIGIN env var
   --events <path>    path to a gzipped events .jsonl.gz file to attach
                      required unless --video is present; previews must
                      have replay or recording playback data
@@ -210,7 +210,7 @@ options:
                      to the local/org team that owns the link
   --billing-kind test_run
                      meter this upload as a natural-language test run
-  --sim <sim>        target a specific sim (see: rnx list)
+  --sim <sim>        target a specific sim (see: peach list)
   --open             open the resulting /preview/<id> url in the browser
   --assets-only      drop API/JSON/HTML records before upload; keep images,
                      fonts, css, js, and binary blobs. live-data demos hit
@@ -219,9 +219,9 @@ options:
   -h, --help
 
 examples:
-  rnx record upload --events ./my-session.jsonl.gz
-  rnx record upload --origin https://contrast.localhost:3000 --events ./my-session.jsonl.gz --open
-  rnx record upload --video /tmp/rnx-flow.mp4 --video-duration-ms 12000
+  peach record upload --events ./my-session.jsonl.gz
+  peach record upload --origin https://contrast.localhost:3000 --events ./my-session.jsonl.gz --open
+  peach record upload --video /tmp/peach-flow.mp4 --video-duration-ms 12000
 `)
 }
 
@@ -494,8 +494,8 @@ export async function runUpload(
   if (!eventsPath && !videoPath) {
     console.error(
       '  preview uploads require playback data: pass --events or --video.\n' +
-        '  for a normal local preview, use `rnx record --mode combined --open`\n' +
-        '  or `rnx maestro test --preview` instead of uploading a bundle-only snapshot.',
+        '  for a normal local preview, use `peach record --mode combined --open`\n' +
+        '  or `peach maestro test --preview` instead of uploading a bundle-only snapshot.',
     )
     rnxExit(1)
   }
@@ -701,14 +701,14 @@ export async function runUpload(
 
   if (!snapshot) {
     console.error(
-      '  could not read bundle snapshot — is rnx running and is the bundle loaded?',
+      '  could not read bundle snapshot — is peach running and is the bundle loaded?',
     )
     rnxExit(2)
   }
   if (!snapshot.bundleUrl) {
     console.error(
-      '  no ?bundle= URL on the current rnx tab.\n' +
-        '  open the app you want to share first (e.g. rnx open 8082), then run upload.',
+      '  no ?bundle= URL on the current peach tab.\n' +
+        '  open the app you want to share first (e.g. peach open 8082), then run upload.',
     )
     rnxExit(2)
   }
@@ -870,7 +870,7 @@ export async function runUpload(
     )
   }
 
-  // priority: RNX_API_KEY env → github runner token → saved credential
+  // priority: PEACH_API_KEY env → github runner token → saved credential
   // file → session token. github runner auth is what keeps installed PR
   // previews from requiring a new Contrast secret.
   const cliAuth = resolveCliAuth()
@@ -879,7 +879,7 @@ export async function runUpload(
   if (!cliAuth) {
     console.error('  preview uploads need auth.')
     console.error(
-      '  set RNX_API_KEY=sk_rnx_..., run `rnx login`, or use the Contrast github runner.',
+      '  set PEACH_API_KEY=sk_rnx_..., run `peach login`, or use the Contrast github runner.',
     )
     rnxExit(1)
   }
@@ -935,7 +935,7 @@ export async function runUpload(
   // asset-registry and are fetched once at engine boot — before the recorder
   // starts — so neither the manifest re-fetch nor recordedFetches captures
   // them and the /preview replay 404s. backfill them here via the shared
-  // fetcher (same code path as the build's `rnx app-fonts stage`) so both
+  // fetcher (same code path as the build's `peach app-fonts stage`) so both
   // pipelines store identical bytes keyed by sha256(url).
   const appFontFiles: PreparedFile[] = []
   const appFontsWire = appFontsWireFromPageHref(snapshot.pageHref) || ''
@@ -1039,11 +1039,11 @@ export async function runUpload(
     bundleMinified: false,
     bundleOrigin,
     runtimeVersion: snapshot.runtimeVersion ?? undefined,
-    // config-only fonts resolved by `rnx open` and carried on the engine
+    // config-only fonts resolved by `peach open` and carried on the engine
     // URL. persist them onto the share meta so /preview/<id> re-applies
     // `?appFonts=` and registers the same typefaces.
     appFonts: appFontsWire || undefined,
-    // configured splash (image + bg) resolved by `rnx open`. persist it so
+    // configured splash (image + bg) resolved by `peach open`. persist it so
     // /preview/<id> re-applies `?appSplash=` and paints the same splash; the
     // image bytes are staged above so the engine's <img> resolves in preview.
     appSplash: appSplashWire || undefined,
@@ -1175,7 +1175,7 @@ export async function runUpload(
     }
     if (e.phase === 'init' && e.status === 401) {
       console.error('  preview upload requires a valid login.')
-      console.error('  run `rnx login` and retry.')
+      console.error('  run `peach login` and retry.')
       rnxExit(1)
     }
     if (e.status === 402) {

package/cli/commands/version.ts

@@ -1,9 +1,9 @@
-// rnx version — one overview of both halves you're running.
+// peach version — one overview of both halves you're running.
 //
-// the rnx CLI and the engine runtime (versioned tarball
+// the peach CLI and the engine runtime (versioned tarball
 // rendered in the browser/electron shell) are versioned independently, which
 // is a frequent "I upgraded but the version didn't change" trap. the terse
-// `rnx --version` flag prints both for scripts; this command adds the
+// `peach --version` flag prints both for scripts; this command adds the
 // channel, a "newer runtime available" hint, and a what's-new pointer.
 
 import fs from 'node:fs'
@@ -22,7 +22,7 @@ export async function runVersion(_args: string[]): Promise<void> {
     : Promise.resolve(null)
   const { IS_BETA, BETA_LABEL } = await import('../../src/beta')
   const suffix = IS_BETA ? ` · ${BETA_LABEL}` : ''
-  console.log(`rnx v${getCliVersion()}${suffix}`)
+  console.log(`peach v${getCliVersion()}${suffix}`)
 
   const runtime = getRuntimeSummary()
   const channel = rnxRuntime.resolveChannel()
@@ -30,7 +30,7 @@ export async function runVersion(_args: string[]): Promise<void> {
     console.log(runtime.primary)
     if (runtime.installedRuntime) console.log(`${runtime.installedRuntime} · ${channel}`)
   } else if (runtime.primary === 'runtime not installed') {
-    console.log(`runtime not installed — run \`rnx runtime install\``)
+    console.log(`runtime not installed — run \`peach runtime install\``)
   } else {
     console.log(`${runtime.primary} · ${channel}`)
   }
@@ -53,10 +53,10 @@ export async function runVersion(_args: string[]): Promise<void> {
     cliUpdatePromise,
   ])
   if (cliUpdate?.outdated) {
-    console.log(`\n  ↑ CLI v${cliUpdate.latestVersion} available; run \`rnx upgrade\``)
+    console.log(`\n  ↑ CLI v${cliUpdate.latestVersion} available; run \`peach upgrade\``)
   }
   if (check.outdated && check.latest) {
-    console.log(`\n  ↑ default runtime v${check.latest} available; run \`rnx upgrade\``)
+    console.log(`\n  ↑ default runtime v${check.latest} available; run \`peach upgrade\``)
   }
 
   console.log(`\n  what's new: ${RNX_CHANGELOG_URL}`)