peachsim 0.1.570 → 0.1.572

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peachsim",
-  "version": "0.1.570",
+  "version": "0.1.572",
   "description": "Vite and Metro plugins, testing drivers, and SDK exports for peach.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",
@@ -46,6 +46,20 @@
       "import": "./dist-lib/swift-submit.mjs",
       "default": "./dist-lib/swift-submit.cjs"
     },
+    "./swift-package": {
+      "types": "./src/swift-package.ts",
+      "source": "./src/swift-package.ts",
+      "bun": "./src/swift-package.ts",
+      "import": "./dist-lib/swift-package.mjs",
+      "default": "./dist-lib/swift-package.cjs"
+    },
+    "./swift-compile": {
+      "types": "./src/swift-compile.ts",
+      "source": "./src/swift-compile.ts",
+      "bun": "./src/swift-compile.ts",
+      "import": "./dist-lib/swift-compile.mjs",
+      "default": "./dist-lib/swift-compile.cjs"
+    },
     "./metro": {
       "source": "./src/metro-plugin.ts",
       "default": "./dist-lib/metro.cjs"
@@ -150,6 +164,13 @@
       "import": "./dist-lib/cloud-contract.mjs",
       "default": "./dist-lib/cloud-contract.cjs"
     },
+    "./cloud-test-args": {
+      "types": "./src/cloud-test-args.ts",
+      "source": "./src/cloud-test-args.ts",
+      "bun": "./src/cloud-test-args.ts",
+      "import": "./dist-lib/cloud-test-args.mjs",
+      "default": "./dist-lib/cloud-test-args.cjs"
+    },
     "./cloud": {
       "types": "./src/cloud.ts",
       "source": "./src/cloud.ts",

package/scripts/dev-server-scanner.ts

@@ -122,7 +122,7 @@ export interface DiscoveredServer {
  *  COULD NOT LOOK MUST NEVER ANSWER AS THOUGH IT LOOKED. silence, timeout and
  *  empty are three different answers, and only `no-manifest` means "there is
  *  nothing there". reading `no-answer` as `no-manifest` is what made
- *  `rnx open` hand back `<base>/index.bundle` for a One app whose manifest
+ *  `peach open` hand back `<base>/index.bundle` for a One app whose manifest
  *  names a different entry point entirely. */
 type ManifestState = 'resolved' | 'no-manifest' | 'no-answer'
 
@@ -871,7 +871,7 @@ export async function probePort(
   buildIconProxyUrl?: (externalUrl: string) => string,
   listeningProcess?: ListeningProcess,
 ): Promise<DiscoveredServer | null> {
-  // callers such as `rnx open <port>` probe one port directly instead of
+  // callers such as `peach open <port>` probe one port directly instead of
   // going through scanDevServers. wait for the optional in-repo registry here
   // too, or a cold CLI process can build the known app's bundle url before its
   // runtime config is available.
@@ -1110,6 +1110,7 @@ export interface ScanOptions {
 function isSootSimSelfServer(server: DiscoveredServer): boolean {
   const bundleId = server.bundleId?.trim().toLowerCase()
   if (bundleId?.startsWith('dev.sootsim.')) return true
+  if (bundleId?.startsWith('dev.peachsim.')) return true
 
   return false
 }
@@ -1175,7 +1176,7 @@ export function __shouldReuseScannerCacheEntry(
   return true
 }
 
-// exported for tests / `rnx debug` — forces the next scan to re-probe.
+// exported for tests / `peach debug` — forces the next scan to re-probe.
 export function __resetScannerCache() {
   portCache.clear()
   knownNonPatched.clear()

package/skills/contrast/SKILL.md

@@ -14,68 +14,68 @@ overview of all available skills and CLI commands in this repo.
 
 ## Peach CLI commands
 
-the `rnx` CLI is the operational surface for booting shells, driving
+the `peach` CLI is the operational surface for booting shells, driving
 automation, inspecting the render tree, and managing sims.
 
 | command | description |
 | --- | --- |
-| `rnx maestro` | author, generate, and run Maestro YAML flows against rnx |
-| `rnx detox` | run existing Detox suites against rnx on headless Chromium |
-| `rnx cleanup` | inspect and reclaim local rnx disk usage |
-| `rnx record` | capture the live sim as webm/mp4/gif, or sample N png frames (--frames) |
-| `rnx film` | record a flow on the flat canvas, play it back on the 3d device stage under a camera cinematic, save a clip |
-| `rnx storage` | manage guest app storage and launch profiles |
-| `rnx permissions` | inspect and change simulated operating-system permissions |
-| `rnx perf` | CPU, React render, shell frame, and scroll-layer profiling |
-| `rnx describe` | curated human-readable UI summary (default inspection tool) |
-| `rnx find` | locate nodes by text / testID / role / type / predicate |
-| `rnx assert` | run any read verb and convert its output into an exit code |
-| `rnx screenshot` | capture PNGs and manage App Store screenshot assets |
-| `rnx get` | read runtime state (tree, a11y, layout, url, count, errors, …) |
-| `rnx do` | drive the app (tap, type, scroll, swipe, key, reload, …) |
-| `rnx wait` | block until the runtime reaches a known state |
-| `rnx shell` | drive shell state and simulator chrome |
-| `rnx mode` | toggle screenshot and 3D display modes |
-| `rnx device` | inspect or change the live device preset for a sim |
-| `rnx network` | inspect live network traffic from the running rnx worker |
-| `rnx logs` | inspect live console output from the running rnx worker |
-| `rnx debug` | drive __sootsimDebug: channels, snapshots, and inspectors |
-| `rnx what-happened` | show recent semantic events: toasts, keyboards, screens, alerts, fetches, errors |
-| `rnx timeline` | control the semantic event timeline (enable opt-in kinds, clear, dump) |
-| `rnx box` | start a local Box or create a cloud Box |
-| `rnx ios` | start an iOS simulator |
-| `rnx android` | start an Android simulator |
-| `rnx open` | load a target into the current sim or open a new one |
-| `rnx list` | list connected sims or available launch drivers |
-| `rnx use` | select a connected sim |
-| `rnx skill` | install and inspect bundled rnx agent skills |
-| `rnx claim` | take an exclusive lease on a sim |
-| `rnx agent` | attached projects + local agent sessions (codex/claude) |
-| `rnx close` | close a connected sim |
-| `rnx setup` | configure optional local conveniences |
-| `rnx compat` | check package compatibility |
-| `rnx report-issue` | send an explicitly approved compatibility report |
-| `rnx desktop` | launch or install the desktop companion |
-| `rnx daemon` | manage the recommended background bridge service |
-| `rnx version` | show the CLI + engine runtime versions you are running |
-| `rnx upgrade` | update the rnx CLI and engine runtime to the latest |
-| `rnx serve` | run the rnx bridge in the foreground |
-| `rnx runtime` | manage engine runtimes under ~/.rnx/runtimes/ |
-| `rnx auth` | inspect active CLI auth |
-| `rnx login` | sign in for preview uploads |
-| `rnx logout` | clear the local desktop auth session |
-| `rnx config` | manage local CLI preferences |
+| `peach maestro` | author, generate, and run Maestro YAML flows against peach |
+| `peach detox` | run existing Detox suites against peach on headless Chromium |
+| `peach cleanup` | inspect and reclaim local peach disk usage |
+| `peach record` | capture the live sim as webm/mp4/gif, or sample N png frames (--frames) |
+| `peach film` | record a flow on the flat canvas, play it back on the 3d device stage under a camera cinematic, save a clip |
+| `peach storage` | manage guest app storage and launch profiles |
+| `peach permissions` | inspect and change simulated operating-system permissions |
+| `peach perf` | CPU, React render, shell frame, and scroll-layer profiling |
+| `peach describe` | curated human-readable UI summary (default inspection tool) |
+| `peach find` | locate nodes by text / testID / role / type / predicate |
+| `peach assert` | run any read verb and convert its output into an exit code |
+| `peach screenshot` | capture PNGs and manage App Store screenshot assets |
+| `peach get` | read runtime state (tree, a11y, layout, url, count, errors, …) |
+| `peach do` | drive the app (tap, type, scroll, swipe, key, reload, …) |
+| `peach wait` | block until the runtime reaches a known state |
+| `peach shell` | drive shell state and simulator chrome |
+| `peach mode` | toggle screenshot and 3D display modes |
+| `peach device` | inspect or change the live device preset for a sim |
+| `peach network` | inspect live network traffic from the running peach worker |
+| `peach logs` | inspect live console output from the running peach worker |
+| `peach debug` | drive __sootsimDebug: channels, snapshots, and inspectors |
+| `peach what-happened` | show recent semantic events: toasts, keyboards, screens, alerts, fetches, errors |
+| `peach timeline` | control the semantic event timeline (enable opt-in kinds, clear, dump) |
+| `peach box` | start a local Box or create a cloud Box |
+| `peach ios` | start an iOS simulator |
+| `peach android` | start an Android simulator |
+| `peach open` | load a target into the current sim or open a new one |
+| `peach list` | list connected sims or available launch drivers |
+| `peach use` | select a connected sim |
+| `peach skill` | install and inspect bundled peach agent skills |
+| `peach claim` | take an exclusive lease on a sim |
+| `peach agent` | attached projects + local agent sessions (codex/claude) |
+| `peach close` | close a connected sim |
+| `peach setup` | configure optional local conveniences |
+| `peach compat` | check package compatibility |
+| `peach report-issue` | send an explicitly approved compatibility report |
+| `peach desktop` | launch or install the desktop companion |
+| `peach daemon` | manage the recommended background bridge service |
+| `peach version` | show the CLI + engine runtime versions you are running |
+| `peach upgrade` | update the peach CLI and engine runtime to the latest |
+| `peach serve` | run the peach bridge in the foreground |
+| `peach runtime` | manage engine runtimes under ~/.peach/runtimes/ |
+| `peach auth` | inspect active CLI auth |
+| `peach login` | sign in for preview uploads |
+| `peach logout` | clear the local desktop auth session |
+| `peach config` | manage local CLI preferences |
 
 ### runtime verb groups
 
 every runtime verb is organized under one of these grouping prefixes.
-run `rnx --help` to see the full list under each group.
+run `peach --help` to see the full list under each group.
 
-- `rnx describe` — summarize the current UI
-- `rnx find <...>` — unified finder (bare text, --testid, --role, --type, --pressable, --visible)
-- `rnx get <noun>` — read runtime state (tree, a11y, url, count, errors, warnings, requests, globals, layout, node)
-- `rnx do <action>` — drive the app (tap, tap-text, tap-id, type, type-into, key, dismiss, scroll, drag, swipe, pinch, reload, shell, sleep, settle, wait)
-- `rnx debug <tool>` — instrumentation (state, js, eval, perf, sample-color, enable/disable channels, snapshots, diff, record, recent)
+- `peach describe` — summarize the current UI
+- `peach find <...>` — unified finder (bare text, --testid, --role, --type, --pressable, --visible)
+- `peach get <noun>` — read runtime state (tree, a11y, url, count, errors, warnings, requests, globals, layout, node)
+- `peach do <action>` — drive the app (tap, tap-text, tap-id, type, type-into, key, dismiss, scroll, drag, swipe, pinch, reload, shell, sleep, settle, wait)
+- `peach debug <tool>` — instrumentation (state, js, eval, perf, sample-color, enable/disable channels, snapshots, diff, record, recent)
 
 ### global flags
 
@@ -93,11 +93,11 @@ skills for working with the Peach native preview engine:
 
 | skill | description |
 | --- | --- |
-| `/rnx-debug` | Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under Peach. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the rnx CLI debug tooling first, not screenshots or ad-hoc logging. |
-| `/rnx-perf` | Optimize Peach engine and app performance — scroll jank, dropped frames, slow animation, idle CPU, memory growth, and "smooth normally but laggy under load" (video calls, busy machines). Covers measuring on the right thread with the right browser, proving each perf tier actually engages via its counters, a CPU-contention test harness, and the map of existing perf machinery so you improve it instead of reinventing it. For general app debugging load /rnx-debug first. |
-| `/rnx-setup` | Get Peach connected to your React Native app with no project setup |
-| `/rnx-test` | Run automated tests against your React Native app under Peach with Maestro YAML or Detox/Jest |
-| `/rnx-visual` | Pixel-level rendering comparison between Peach and native iOS — fonts, gradients, shadows, image fidelity |
+| `/peach-debug` | Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under Peach. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the peach CLI debug tooling first, not screenshots or ad-hoc logging. |
+| `/peach-perf` | Optimize Peach engine and app performance — scroll jank, dropped frames, slow animation, idle CPU, memory growth, and "smooth normally but laggy under load" (video calls, busy machines). Covers measuring on the right thread with the right browser, proving each perf tier actually engages via its counters, a CPU-contention test harness, and the map of existing perf machinery so you improve it instead of reinventing it. For general app debugging load /peach-debug first. |
+| `/peach-setup` | Get Peach connected to your React Native app with no project setup |
+| `/peach-test` | Run automated tests against your React Native app under Peach with Maestro YAML or Detox/Jest |
+| `/peach-visual` | Pixel-level rendering comparison between Peach and native iOS — fonts, gradients, shadows, image fidelity |
 
 ## automatic settling
 
@@ -115,18 +115,18 @@ commands in your own `sleep` or chain `do settle` "just to be safe"**.
   `type-into`, `key`, `key-sequence`, `keycode`, `drag`, `swipe`,
   `long-press`, `touch`, `gesture`, `pinch`, `scroll`, `shell`)
   the CLI polls the layout hash until it is stable for two consecutive
-  frames. budget: **400 ms for agents** (`RNX_AGENT=1`, set by the
+  frames. budget: **400 ms for agents** (`PEACH_AGENT=1`, set by the
   harness), 200 ms for humans.
 
 what this means:
 
-- `rnx do tap-id login` then `rnx find "Welcome"` Just Works™.
-- you only need `rnx do settle <seconds>` or `rnx wait idle
+- `peach do tap-id login` then `peach find "Welcome"` Just Works™.
+- you only need `peach do settle <seconds>` or `peach wait idle
   --max-ms <N>` when the CLI explicitly prints
   `⚠ auto-wait timed out after Nms — next command may see mid-animation
   state`, or when the transition you care about lasts longer than ~400 ms
   (full stack navigation, crossfades, video load).
-- opt-out: `--no-wait` on a single command, `RNX_NO_AUTO_WAIT=1`
+- opt-out: `--no-wait` on a single command, `PEACH_NO_AUTO_WAIT=1`
   for a whole lane.
 - if a read keeps racing its write, the fix is **never** a blind `sleep` —
   prefer `wait selector`, `wait ready`, `wait idle`, or a longer
@@ -139,27 +139,27 @@ what this means:
 
 ```sh
 bun dev                              # start everything
-rnx dev -- pnpm dev              # wrap a bundler
-rnx open 8081                    # load an app
-rnx describe                     # inspect the UI tree
+peach dev -- pnpm dev              # wrap a bundler
+peach open 8081                    # load an app
+peach describe                     # inspect the UI tree
 ```
 
 ### debugging
 
 ```sh
-rnx get errors 5                 # recent console errors
-rnx get requests 5               # recent failed requests
-rnx debug snapshot before        # capture state
-rnx debug diff before after      # compare snapshots
-rnx debug state shell            # runtime state dump
+peach get errors 5                 # recent console errors
+peach get requests 5               # recent failed requests
+peach debug snapshot before        # capture state
+peach debug diff before after      # compare snapshots
+peach debug state shell            # runtime state dump
 ```
 
 ### inspection
 
 ```sh
-rnx describe                     # visible elements
-rnx find "Sign in"               # find by text
-rnx find --testid loginButton    # find by testID
-rnx do tap-text "Submit"         # tap by text
-rnx do type "hello"              # type text
+peach describe                     # visible elements
+peach find "Sign in"               # find by text
+peach find --testid loginButton    # find by testID
+peach do tap-text "Submit"         # tap by text
+peach do type "hello"              # type text
 ```

package/skills/{rnx-debug → peach-debug}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: rnx-debug
-description: Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under Peach. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the rnx CLI debug tooling first, not screenshots or ad-hoc logging.
+name: peach-debug
+description: Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under Peach. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the peach CLI debug tooling first, not screenshots or ad-hoc logging.
 ---
 
 # Peach debug
@@ -10,15 +10,15 @@ covers debugging, performance, and accessibility — three branches that
 share the same CLI primitives, the same auto-settling contract, and the
 same diff/snapshot workflow. start here for any rendering, interaction,
 event-order, or correctness question. for pixel-level rendering fidelity
-load `/rnx-visual` instead.
+load `/peach-visual` instead.
 
-> needs a connected, pinned sim. if `rnx describe` errors, load
-> `/rnx-setup` first.
+> needs a connected, pinned sim. if `peach describe` errors, load
+> `/peach-setup` first.
 
 ## principle — drive the CLI, don't probe by hand
 
 for any rendering, animation, gesture, or interaction bug, reach for the
-rnx CLI debug tooling **first** — `describe` and `find` to read the
+peach CLI debug tooling **first** — `describe` and `find` to read the
 tree, `debug snapshot` + `debug diff` to capture before/after, `debug
 recent` on a channel and `perf shell` for frame-by-frame stats, and the
 timeline for "what just happened". **do not** debug these by eye with
@@ -44,13 +44,13 @@ regression test. a pile of ad-hoc logs helps no one and gets deleted.
 - "screen reader can't find this / wrong label / tap target too small" → [accessibility](#branch--accessibility)
 - "I want to see what just happened" (ephemeral toast, async navigation,
   fetch + alert sequence) → [the timeline](#the-timeline-what-happened)
-- "I want pixel-level fidelity to iOS" → load `/rnx-visual`
-- "I want to author a test" → load `/rnx-test`
+- "I want pixel-level fidelity to iOS" → load `/peach-visual`
+- "I want to author a test" → load `/peach-test`
 
 ## anti-patterns (apply to every branch)
 
 - **`a1`/`a2`/`b0` style ids mean Peach sims, never browser tabs.** when a user
-  says "look at a3", that's the `rnx list` sim id. do not open chrome
+  says "look at a3", that's the `peach list` sim id. do not open chrome
   MCP unless the user explicitly says "use chrome" — the canvas has no
   DOM to inspect anyway.
 - **the CLI auto-settles. don't add `sleep`.** every read waits up to
@@ -62,10 +62,10 @@ regression test. a pile of ad-hoc logs helps no one and gets deleted.
   changes, and duplicate strings. add `testID` during implementation and
   query against it.
 - **pin a sim once.** if more than one is live, an unpinned command
-  refuses to choose. run `rnx use <id>` at the start of the workflow.
-- **keep one sim and reuse its browser tab.** before `rnx open`, run
-  `rnx list --all`. pin the target and use `rnx do reload`; a plain
-  `rnx open <target>` also navigates the saved sim. reserve `--new` for a
+  refuses to choose. run `peach use <id>` at the start of the workflow.
+- **keep one sim and reuse its browser tab.** before `peach open`, run
+  `peach list --all`. pin the target and use `peach do reload`; a plain
+  `peach open <target>` also navigates the saved sim. reserve `--new` for a
   genuinely concurrent sim. repeated browser trees consume memory and CPU on a
   shared machine.
 - **`debug eval` is an escape hatch.** if a top-level command feels
@@ -95,13 +95,13 @@ fetches resolve. the timeline records them so you can ask "what
 happened" instead of racing the UI with `find`.
 
 ```sh
-rnx timeline start                       # arm recording (cheap kinds default-on)
+peach timeline start                       # arm recording (cheap kinds default-on)
 # reproduce the flow
-rnx what-happened                        # events since the last CLI call
-rnx what-happened --since 10s            # absolute window
-rnx what-happened --kinds toast,fetch    # filter to a few kinds
-rnx what-happened --summary              # one-line counts
-rnx what-happened --flow                 # section events by screen/route
+peach what-happened                        # events since the last CLI call
+peach what-happened --since 10s            # absolute window
+peach what-happened --kinds toast,fetch    # filter to a few kinds
+peach what-happened --summary              # one-line counts
+peach what-happened --flow                 # section events by screen/route
 ```
 
 semantic kinds the timeline understands: `keyboard`, `screen`, `route`,
@@ -109,12 +109,12 @@ semantic kinds the timeline understands: `keyboard`, `screen`, `route`,
 `gesture`, `text-input`, `reanimated`, `animation`, `fetch`, `console`,
 `app-launch`, `shell`. cheap kinds record by default; heavier kinds
 (scroll, gesture, text-input, reanimated, animation) opt in via
-`rnx timeline start scroll,gesture,…`.
+`peach timeline start scroll,gesture,…`.
 
 every other CLI command also prints a one-line footer for events since
 the last call — that's the headline indicator. when the footer is empty,
 there's nothing new to look at; when it says `since last: 1 error · 1
-toast · 1 screen push`, run `rnx what-happened` to see the detail.
+toast · 1 screen push`, run `peach what-happened` to see the detail.
 
 > reach for the timeline first when the question involves *something
 > that appeared briefly and disappeared*. it's faster than a screenshot
@@ -135,11 +135,11 @@ need a manual wait when:
    (no pulsing dots, no shimmer, no looping Lottie).
 
 ```sh
-rnx do settle 5                # wait up to 5s for layout stability
-rnx wait idle --max-ms 5000    # same thing under the `wait` verb
-rnx wait idle --strict         # also require animation flags clear
-rnx do tap-id play --no-wait   # skip auto-settle on one command
-RNX_NO_AUTO_WAIT=1 rnx ... # disable auto-settle for a lane
+peach do settle 5                # wait up to 5s for layout stability
+peach wait idle --max-ms 5000    # same thing under the `wait` verb
+peach wait idle --strict         # also require animation flags clear
+peach do tap-id play --no-wait   # skip auto-settle on one command
+PEACH_NO_AUTO_WAIT=1 peach ... # disable auto-settle for a lane
 ```
 
 ## branch — debugging
@@ -147,14 +147,14 @@ RNX_NO_AUTO_WAIT=1 rnx ... # disable auto-settle for a lane
 the playbook for "wrong tree / wrong props / wrong handler":
 
 ```sh
-rnx describe                         # what's on screen now
-rnx get errors 5                     # any console smoke?
-rnx find --testid <node>             # locate the suspect
-rnx debug snapshot before
+peach describe                         # what's on screen now
+peach get errors 5                     # any console smoke?
+peach find --testid <node>             # locate the suspect
+peach debug snapshot before
 # reproduce
-rnx debug snapshot after
-rnx debug diff before after          # structural diff: what changed?
-rnx what-happened                    # timeline events during the repro
+peach debug snapshot after
+peach debug diff before after          # structural diff: what changed?
+peach what-happened                    # timeline events during the repro
 ```
 
 when the repro needs several closely timed inputs, replace the individual
@@ -162,15 +162,15 @@ write calls with one inline batch so WebSocket scheduling cannot change the
 gesture:
 
 ```sh
-rnx do touch down 200 600 --then sleep 0.03 --then touch move 200 250 --then touch up 200 250
+peach do touch down 200 600 --then sleep 0.03 --then touch move 200 250 --then touch up 200 250
 ```
 
 for nested scroll ownership or momentum transfer, compare the shell's resolved
 gesture chain with the published scroll registry:
 
 ```sh
-rnx debug state scroll-input
-rnx debug state scroll-mirror
+peach debug state scroll-input
+peach debug state scroll-mirror
 ```
 
 reading `describe` output:
@@ -187,9 +187,9 @@ for transitions, alerts, native UI, or anything spanning the shell ↔
 tenant boundary, lean on the timeline before reaching for traces:
 
 ```sh
-rnx timeline start
+peach timeline start
 # reproduce the launch / dismiss / alert
-rnx what-happened --kinds shell,alert,screen,animation
+peach what-happened --kinds shell,alert,screen,animation
 ```
 
 you're done when:
@@ -202,10 +202,10 @@ you're done when:
 ## branch — performance
 
 ```sh
-rnx perf shell start                  # arm capture (also clears prior frames)
+peach perf shell start                  # arm capture (also clears prior frames)
 # reproduce the slow interaction
-rnx perf shell stop                   # full report, including worst frames
-rnx perf shell stop --json            # machine-readable summary
+peach perf shell stop                   # full report, including worst frames
+peach perf shell stop --json            # machine-readable summary
 ```
 
 `perf shell` output:
@@ -227,8 +227,8 @@ budget. **p95 >20 ms is visible jank for a scrolling surface.**
 profiling a whole flow:
 
 ```sh
-rnx maestro test .maestro/scroll-feed.yaml --profile # per-step + frame stats
-rnx perf cpu --duration 5 --output /tmp/trace.cpuprofile  # sampled CPU
+peach maestro test .maestro/scroll-feed.yaml --profile # per-step + frame stats
+peach perf cpu --duration 5 --output /tmp/trace.cpuprofile  # sampled CPU
 ```
 
 common patterns → first probe:
@@ -245,11 +245,11 @@ debug channels that help, but cost 1–3 ms/frame on their own — enable
 only what you're investigating:
 
 ```sh
-rnx debug enable layout,onlayout,render,animated
+peach debug enable layout,onlayout,render,animated
 # reproduce
-rnx debug recent layout 20            # last 20 layout events
-rnx debug recent render 20            # last 20 draw passes
-rnx debug disable layout,onlayout,render,animated
+peach debug recent layout 20            # last 20 layout events
+peach debug recent render 20            # last 20 draw passes
+peach debug disable layout,onlayout,render,animated
 ```
 
 you're done when: a p95 number for the interaction + named hot path +
@@ -269,9 +269,9 @@ watch out for:
 ## branch — accessibility
 
 ```sh
-rnx get a11y                          # roles, labels, hints, and target geometry
-rnx get layout --styling              # boxes, styles, and native pixel contrast
-rnx describe --a11y                   # inline a11y info on every node
+peach get a11y                          # roles, labels, hints, and target geometry
+peach get layout --styling              # boxes, styles, and native pixel contrast
+peach describe --a11y                   # inline a11y info on every node
 ```
 
 native styled layout reads rendered pixels rather than inferring contrast from
@@ -287,9 +287,9 @@ contrast summary format:
 finding offenders fast:
 
 ```sh
-rnx find --no-label                   # interactive nodes missing label
-rnx find --no-role                    # interactive nodes missing role
-rnx find --pressable --max-dim 44     # undersized tap targets
+peach find --no-label                   # interactive nodes missing label
+peach find --no-role                    # interactive nodes missing role
+peach find --pressable --max-dim 44     # undersized tap targets
 ```
 
 what gets checked:
@@ -298,7 +298,7 @@ what gets checked:
 - **missing roles** — `Pressable`/`Touchable` without `accessibilityRole`
 - **missing hints** — complex interactions without `accessibilityHint`
 - **touch target size** — tappable nodes with hitSlop-expanded rect <44×44
-- **contrast** — run `rnx get layout --styling`; it samples final text and
+- **contrast** — run `peach get layout --styling`; it samples final text and
   text-suppressed background pixels, including gradients and composited opacity
 - **label / visible-text mismatch** — label that reads differently from
   the text VoiceOver would fall back to (often a translation bug)
@@ -315,11 +315,11 @@ triage order:
 fix → verify loop (the same shape as debugging):
 
 ```sh
-rnx get a11y > before-a11y.txt
-rnx get layout --styling --json > before-layout.json
+peach get a11y > before-a11y.txt
+peach get layout --styling --json > before-layout.json
 # apply the fix
-rnx get a11y > after-a11y.txt
-rnx get layout --styling --json > after-layout.json
+peach get a11y > after-a11y.txt
+peach get layout --styling --json > after-layout.json
 diff before-a11y.txt after-a11y.txt
 diff before-layout.json after-layout.json
 ```
@@ -371,7 +371,7 @@ type names sneak in).
 ## recovery — common failure modes
 
 - **`describe` returns nothing** — no sim pinned, or the app isn't
-  loaded. load `/rnx-setup` and re-confirm.
+  loaded. load `/peach-setup` and re-confirm.
 - **`find` returns multiple matches** — narrow with `--testid`,
   `--visible`, or both.
 - **`perf shell` reports zero frames** — you didn't run `perf shell start`
@@ -390,45 +390,45 @@ type names sneak in).
 ### finding and interacting
 
 ```sh
-rnx describe                          # all visible elements with styles
-rnx describe button                   # filter by text/role/label/testID
-rnx describe --testid foo             # only the subtree under a testID
-rnx describe --verbose                # include every style property
-
-rnx find "Sign in"                    # by text content
-rnx find --testid loginButton
-rnx find --role button
-rnx find --pressable
-rnx find --visible                    # only on-screen nodes
-
-rnx do tap-id loginButton             # tap by testID (preferred)
-rnx do tap-text "Submit"              # tap by text
-rnx do tap 196 400                    # tap at coordinates
-rnx do type "hello world"             # type into focused input
-rnx do type-into emailInput "a@b"     # focus then type
-rnx do key return                     # special key (return, backspace, …)
-rnx do scroll feed-list 0 500         # scroll a testID to absolute x/y offsets
-rnx do swipe feed-list left           # directional swipe
-rnx do long-press messageRow 800      # ms hold
+peach describe                          # all visible elements with styles
+peach describe button                   # filter by text/role/label/testID
+peach describe --testid foo             # only the subtree under a testID
+peach describe --verbose                # include every style property
+
+peach find "Sign in"                    # by text content
+peach find --testid loginButton
+peach find --role button
+peach find --pressable
+peach find --visible                    # only on-screen nodes
+
+peach do tap-id loginButton             # tap by testID (preferred)
+peach do tap-text "Submit"              # tap by text
+peach do tap 196 400                    # tap at coordinates
+peach do type "hello world"             # type into focused input
+peach do type-into emailInput "a@b"     # focus then type
+peach do key return                     # special key (return, backspace, …)
+peach do scroll feed-list 0 500         # scroll a testID to absolute x/y offsets
+peach do swipe feed-list left           # directional swipe
+peach do long-press messageRow 800      # ms hold
 ```
 
 ### errors and requests
 
 ```sh
-rnx get errors 5                      # last 5 console errors
-rnx get warnings 5
-rnx get requests 5                    # recent failed requests
-rnx logs --since 30s                  # recent console output
-rnx network --since 30s               # recent network traffic
+peach get errors 5                      # last 5 console errors
+peach get warnings 5
+peach get requests 5                    # recent failed requests
+peach logs --since 30s                  # recent console output
+peach network --since 30s               # recent network traffic
 ```
 
 ### snapshots and diff
 
 ```sh
-rnx debug snapshot before
+peach debug snapshot before
 # interact
-rnx debug snapshot after
-rnx debug diff before after           # added / removed / changed nodes
+peach debug snapshot after
+peach debug diff before after           # added / removed / changed nodes
 ```
 
 ### debug channels
@@ -437,7 +437,7 @@ useful: `animated`, `layout`, `onlayout`, `render`, `sheets`, `portals`,
 `gesture`, `scroll`, `text`, `image`.
 
 ```sh
-rnx debug enable animated,layout,sheets,portals
-rnx debug recent layout 20            # last 20 events on the channel
-rnx debug disable animated,layout,sheets,portals
+peach debug enable animated,layout,sheets,portals
+peach debug recent layout 20            # last 20 events on the channel
+peach debug disable animated,layout,sheets,portals
 ```