clawdex-mobile 3.0.0 → 4.0.0

package/bin/clawdex.js

@@ -10,13 +10,14 @@ function printUsage() {
   console.log(`Usage: clawdex <command> [options]
 
 Commands:
-  init [--no-start] [--platform <mobile|ios|android>]
-      Run interactive onboarding and secure setup.
-      By default, this also starts bridge + Expo at the end.
-      Use --no-start to skip auto-launch.
+  init [--no-start]
+      Run interactive bridge onboarding and secure setup.
+      By default, this also starts the secure bridge in the foreground.
+      Use --no-start to configure only.
 
   stop
-      Stop bridge + Expo services for this project.
+      Stop bridge services for this project.
+      Also stops a local Expo dev process if one was started from this checkout.
 
   upgrade [--version <latest|x.y.z>] [--restart]
   update  [--version <latest|x.y.z>] [--restart]
@@ -146,7 +147,7 @@ function runUpgrade(args) {
 
   console.log(`Current clawdex-mobile version: ${previousVersion}`);
   if (!options.noStop) {
-    console.log("Stopping running bridge/Expo services before upgrade...");
+    console.log("Stopping running local services before upgrade...");
     const stopResult = runScript("stop-services.sh", [], { exitOnComplete: false });
     if (!stopResult.ok) {
       console.error("error: failed to stop services before upgrade.");

package/docs/setup-and-operations.md

@@ -6,11 +6,12 @@ This guide is the detailed companion to the top-level `README.md`.
 
 After `clawdex init`, expected sequence:
 
-1. Bridge health passes (`Bridge health check passed.`)
-2. Expo starts (`Starting Expo (mobile) in background...`)
-3. You may briefly see a spinner (`Waiting for Expo output - ...`)
-4. Expo output begins (`expo start --host lan`, QR block, `Metro waiting on exp://...`)
-5. Press Enter to detach onboarding while Expo + bridge keep running
+1. Secure config is written or reused
+2. The bridge starts in the foreground
+3. A pairing QR is printed for the mobile app
+4. Bridge logs stay attached until you stop the process
+
+Published npm releases bundle prebuilt bridge binaries for `darwin-arm64`, `linux-x64`, and `win32-x64`. On those hosts, normal bridge startup does not require a Rust compile. Intel Macs fall back to a local Rust build.
 
 ## Manual Secure Setup (No Wizard)
 
@@ -37,7 +38,13 @@ Creates/updates:
 npm run secure:bridge
 ```
 
-### 4) Start Expo
+### 4) Pair from the mobile app
+
+Open the installed mobile app on your phone, then scan the bridge QR. If needed, enter the bridge URL manually (for example `http://100.x.y.z:8787` or `http://192.168.x.y:8787`). The chosen bridge URL is stored on-device and can be changed later in Settings.
+
+## Local Mobile Development Only
+
+If you are developing the mobile app from this repo, start Expo separately:
 
 ```bash
 npm run mobile
@@ -45,15 +52,12 @@ npm run mobile
 
 `npm run mobile` uses `scripts/start-expo.sh`, which sets `REACT_NATIVE_PACKAGER_HOSTNAME` from your secure config so QR resolution is predictable.
 
-On first app launch, onboarding will ask for your bridge URL (for example `http://100.x.y.z:8787` or `http://192.168.x.y:8787`). This URL is stored on-device and can be changed later in Settings.
-
 ## Advanced Knobs
 
 Optional environment variables:
 
 - `CLAWDEX_SETUP_VERBOSE=true` — show full installer output
-- `BRIDGE_HEALTH_WAIT_SECS=300` — max wait for bridge `/health`
-- `EXPO_OUTPUT_WAIT_SECS=90` — spinner timeout before streaming Expo logs
+- `CLAWDEX_BRIDGE_FORCE_SOURCE_BUILD=true` — ignore a bundled bridge binary and build from local Rust sources instead
 - `EXPO_AUTO_REPAIR=true` — auto-repair React Native runtime on `npm run mobile`
 - `EXPO_CLEAR_CACHE=true` — force `expo start --clear` via `npm run mobile`
 
@@ -65,7 +69,8 @@ npm run teardown
 
 Can:
 
-- stop Expo + bridge
+- stop the bridge
+- also stop local Expo if you started it from this repo
 - remove generated artifacts (`.env.secure`, `.bridge.log`, `.expo.log`, pid files)
 - optionally reset `apps/mobile/.env` from `.env.example`
 - optionally run `tailscale down`
@@ -94,7 +99,7 @@ npm run teardown -- --yes
 
 | Variable | Purpose |
 |---|---|
-| `EXPO_PUBLIC_HOST_BRIDGE_TOKEN` | token sent by mobile client |
+| `EXPO_PUBLIC_HOST_BRIDGE_TOKEN` | token used by local mobile dev builds |
 | `EXPO_PUBLIC_ALLOW_QUERY_TOKEN_AUTH` | query-token behavior for WebSocket auth fallback |
 | `EXPO_PUBLIC_ALLOW_INSECURE_REMOTE_BRIDGE` | suppress insecure-HTTP warning |
 | `EXPO_PUBLIC_PRIVACY_POLICY_URL` | in-app Privacy link |

package/docs/troubleshooting.md

@@ -1,23 +1,16 @@
 # Troubleshooting
 
-## Onboarding looks stuck before Expo logs appear
+## Bridge startup seems slow
 
-- Expo startup can be slow on first launch.
-- You should see: `Waiting for Expo output ...`
-- Increase timeout if needed:
-
-```bash
-EXPO_OUTPUT_WAIT_SECS=180 clawdex init
-```
-
-- If Expo never emits logs:
-
-```bash
-tail -n 120 .expo.log
-```
+- `clawdex init` no longer starts Expo for the shipped app.
+- Published npm installs should use a bundled bridge binary on `darwin-arm64`, `linux-x64`, and `win32-x64`.
+- If startup is still compiling Rust, you are usually on a source checkout, an unsupported host, or a package without bundled bridge binaries.
+- The slow parts are usually npm dependency install/repair or the first Rust bridge build on source-based setups.
+- If you want to skip the interactive wizard after initial setup, use `npm run secure:bridge`.
 
 ## Expo starts but QR/network is wrong
 
+- This only applies when you are developing the mobile app locally from the repo.
 - Re-run `npm run secure:setup`
 - Confirm `.env.secure` has correct `BRIDGE_HOST`
 - Restart `npm run mobile`
@@ -38,13 +31,14 @@ npm run stop:services
 
 ## Bridge auth errors (`401`, invalid token)
 
-- Ensure `BRIDGE_AUTH_TOKEN` in `.env.secure` matches `EXPO_PUBLIC_HOST_BRIDGE_TOKEN` in `apps/mobile/.env`
-- Restart bridge + Expo after token changes
+- For the shipped mobile app, rescan the bridge QR or update the stored token in Settings.
+- For a local dev build, also ensure `BRIDGE_AUTH_TOKEN` in `.env.secure` matches `EXPO_PUBLIC_HOST_BRIDGE_TOKEN` in `apps/mobile/.env`.
+- Restart the bridge after token changes.
 
 ## Tailscale issues
 
 - Verify host and phone are on the same Tailscale network
-- Check host IP (`tailscale ip -4`) and mobile `.env` URL
+- Check host IP (`tailscale ip -4`) and the bridge URL saved in the mobile app
 
 ## `codex` not found
 
@@ -53,6 +47,8 @@ npm run stop:services
 
 ## Bridge build fails with `linker 'cc' not found`
 
+This only applies when the bridge is building from Rust source instead of using a bundled binary.
+
 Install C build tools:
 
 ```bash
@@ -106,7 +102,7 @@ npm run start -- --clear
 
 ## Plan mode errors (`RPC-32600` invalid `collaborationMode`)
 
-- Restart Expo and reload app bundle
+- Restart the app and reconnect to the bridge
 - Ensure bridge/mobile revisions match
 - Run API test if needed:
 
@@ -118,4 +114,4 @@ npm run -w apps/mobile test -- --runInBand src/api/__tests__/client.test.ts
 
 - Ensure revision supports `turn/interrupt`
 - If run already finished, stop button disappears by design
-- Pull latest, restart bridge, reload Expo bundle
+- Pull latest, restart bridge, then retry from the mobile app

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawdex-mobile",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "homepage": "https://github.com/Mohit-Patil/clawdex-mobile#readme",
   "repository": {
     "type": "git",
@@ -21,11 +21,12 @@
     "ios": "./scripts/start-expo.sh ios",
     "android": "./scripts/start-expo.sh android",
     "bridge": "BRIDGE_WORKDIR=$(pwd) npm run -w @codex/rust-bridge dev",
+    "bridge:package:stage-current": "node ./scripts/bridge-binary.js stage-current",
     "setup:wizard": "./scripts/setup-wizard.sh",
     "stop:services": "./scripts/stop-services.sh",
     "secure:setup": "./scripts/setup-secure-dev.sh",
-    "secure:bridge": "./scripts/start-bridge-secure.sh",
-    "secure:bridge:dev": "BRIDGE_RUN_MODE=dev ./scripts/start-bridge-secure.sh",
+    "secure:bridge": "node ./scripts/start-bridge-secure.js",
+    "secure:bridge:dev": "node ./scripts/start-bridge-secure.js --dev",
     "bridge:ts": "BRIDGE_WORKDIR=$(pwd) npm run -w @codex/mac-bridge dev",
     "version:sync": "node scripts/sync-versions.js",
     "build": "npm run --workspaces build",

package/scripts/bridge-binary.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+const SUPPORTED_RUNTIME_TARGETS = {
+  "darwin-arm64": {
+    platform: "darwin",
+    arch: "arm64",
+    rustTarget: "aarch64-apple-darwin",
+    binaryName: "codex-rust-bridge",
+  },
+  "linux-x64": {
+    platform: "linux",
+    arch: "x64",
+    rustTarget: "x86_64-unknown-linux-gnu",
+    binaryName: "codex-rust-bridge",
+  },
+  "win32-x64": {
+    platform: "win32",
+    arch: "x64",
+    rustTarget: "x86_64-pc-windows-msvc",
+    binaryName: "codex-rust-bridge.exe",
+  },
+};
+
+function repoRoot() {
+  return path.resolve(__dirname, "..");
+}
+
+function resolveRuntimeTarget(platform = os.platform(), arch = os.arch()) {
+  for (const [target, metadata] of Object.entries(SUPPORTED_RUNTIME_TARGETS)) {
+    if (metadata.platform === platform && metadata.arch === arch) {
+      return target;
+    }
+  }
+  return null;
+}
+
+function binaryNameForTarget(target) {
+  const metadata = SUPPORTED_RUNTIME_TARGETS[target];
+  if (!metadata) {
+    throw new Error(`Unsupported bridge target '${target}'.`);
+  }
+  return metadata.binaryName;
+}
+
+function packagedBinaryPath(rootDir = repoRoot(), target = resolveRuntimeTarget()) {
+  if (!target) {
+    return null;
+  }
+  return path.join(rootDir, "vendor", "bridge-binaries", target, binaryNameForTarget(target));
+}
+
+function builtBinaryPath(rootDir = repoRoot(), platform = os.platform()) {
+  const binaryName = platform === "win32" ? "codex-rust-bridge.exe" : "codex-rust-bridge";
+  return path.join(rootDir, "services", "rust-bridge", "target", "release", binaryName);
+}
+
+function ensureExecutable(filePath) {
+  if (process.platform !== "win32") {
+    fs.chmodSync(filePath, 0o755);
+  }
+}
+
+function stageBinary({ rootDir = repoRoot(), from, target = resolveRuntimeTarget() }) {
+  if (!from) {
+    throw new Error("--from is required.");
+  }
+  if (!target) {
+    throw new Error("No supported runtime target for this host. Pass --target explicitly.");
+  }
+
+  const destination = packagedBinaryPath(rootDir, target);
+  if (!destination) {
+    throw new Error(`Unable to compute packaged path for target '${target}'.`);
+  }
+
+  fs.mkdirSync(path.dirname(destination), { recursive: true });
+  fs.copyFileSync(from, destination);
+  ensureExecutable(destination);
+  return destination;
+}
+
+function parseArgs(argv) {
+  const positional = [];
+  const flags = {};
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = argv[index];
+    if (!value.startsWith("--")) {
+      positional.push(value);
+      continue;
+    }
+
+    const key = value.slice(2);
+    const next = argv[index + 1];
+    if (!next || next.startsWith("--")) {
+      flags[key] = true;
+      continue;
+    }
+    flags[key] = next;
+    index += 1;
+  }
+
+  return { positional, flags };
+}
+
+function main() {
+  const { positional, flags } = parseArgs(process.argv.slice(2));
+  const command = positional[0];
+  const rootDir = flags.root ? path.resolve(flags.root) : repoRoot();
+
+  switch (command) {
+    case "current-target": {
+      const target = resolveRuntimeTarget();
+      if (!target) {
+        process.exit(1);
+      }
+      console.log(target);
+      return;
+    }
+    case "has-current-packaged": {
+      const filePath = packagedBinaryPath(rootDir);
+      if (filePath && fs.existsSync(filePath)) {
+        console.log(filePath);
+        return;
+      }
+      process.exit(1);
+      return;
+    }
+    case "current-packaged-path": {
+      const target = flags.target || resolveRuntimeTarget();
+      const filePath = packagedBinaryPath(rootDir, target);
+      if (!filePath) {
+        process.exit(1);
+      }
+      console.log(filePath);
+      return;
+    }
+    case "current-built-path": {
+      console.log(builtBinaryPath(rootDir));
+      return;
+    }
+    case "stage-current": {
+      const destination = stageBinary({
+        rootDir,
+        from: builtBinaryPath(rootDir),
+        target: flags.target || resolveRuntimeTarget(),
+      });
+      console.log(destination);
+      return;
+    }
+    case "stage": {
+      const destination = stageBinary({
+        rootDir,
+        from: flags.from ? path.resolve(flags.from) : "",
+        target: flags.target || resolveRuntimeTarget(),
+      });
+      console.log(destination);
+      return;
+    }
+    default:
+      console.error("Usage:");
+      console.error("  node scripts/bridge-binary.js current-target");
+      console.error("  node scripts/bridge-binary.js has-current-packaged");
+      console.error("  node scripts/bridge-binary.js current-packaged-path [--target <target>]");
+      console.error("  node scripts/bridge-binary.js current-built-path");
+      console.error("  node scripts/bridge-binary.js stage-current [--target <target>]");
+      console.error("  node scripts/bridge-binary.js stage --from <binary> [--target <target>]");
+      process.exit(1);
+  }
+}
+
+module.exports = {
+  SUPPORTED_RUNTIME_TARGETS,
+  binaryNameForTarget,
+  builtBinaryPath,
+  ensureExecutable,
+  packagedBinaryPath,
+  resolveRuntimeTarget,
+  stageBinary,
+};
+
+if (require.main === module) {
+  try {
+    main();
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+}

package/scripts/setup-wizard.sh

@@ -28,16 +28,7 @@ NETWORK_MODE=""
 TAILSCALE_IP=""
 BRIDGE_HOST=""
 BRIDGE_PORT=""
-EXPO_MODE="mobile"
 AUTO_START="true"
-TARGET_PLATFORM="mobile"
-BRIDGE_PID=""
-EXPO_PID=""
-BRIDGE_LOG="$ROOT_DIR/.bridge.log"
-EXPO_LOG="$ROOT_DIR/.expo.log"
-BRIDGE_PID_FILE="$ROOT_DIR/.bridge.pid"
-EXPO_PID_FILE="$ROOT_DIR/.expo.pid"
-KEEP_SERVICES_RUNNING="false"
 SECURE_ENV_FILE="$ROOT_DIR/.env.secure"
 MENU_RESULT=""
 SECTION_COUNT=0
@@ -45,8 +36,6 @@ RAIL_GLYPH="${DIM}│${RESET}"
 RAIL_BRANCH="${DIM}├─${RESET}"
 RAIL_CHILD="${DIM}│${RESET}"
 OS_NAME="$(uname -s)"
-EXPO_STOP_PATTERN="$ROOT_DIR/.*/expo start|$ROOT_DIR/node_modules/.bin/expo start"
-BRIDGE_STOP_PATTERN="$ROOT_DIR/services/rust-bridge|codex-rust-bridge|@codex/rust-bridge"
 
 rail_echo() { printf "%s %s\n" "$RAIL_GLYPH" "$1"; }
 rail_blank() { printf "%s\n" "$RAIL_GLYPH"; }
@@ -81,46 +70,6 @@ run_quiet_command() {
   return 1
 }
 
-list_matching_pids() {
-  local pattern="$1"
-  pgrep -f "$pattern" 2>/dev/null || true
-}
-
-stop_process_group_by_pattern() {
-  local label="$1"
-  local pattern="$2"
-  local pids=""
-  local remaining=""
-  local pid=""
-
-  pids="$(list_matching_pids "$pattern")"
-  if [[ -z "$pids" ]]; then
-    return 0
-  fi
-
-  info "Stopping $label process group: $pids"
-  while IFS= read -r pid; do
-    [[ -z "$pid" ]] && continue
-    kill -TERM "$pid" >/dev/null 2>&1 || true
-  done <<<"$pids"
-
-  sleep 1
-
-  while IFS= read -r pid; do
-    [[ -z "$pid" ]] && continue
-    if kill -0 "$pid" >/dev/null 2>&1; then
-      remaining+="$pid "
-      kill -KILL "$pid" >/dev/null 2>&1 || true
-    fi
-  done <<<"$pids"
-
-  if [[ -n "${remaining// }" ]]; then
-    warn "Force-stopped $label processes: $remaining"
-  fi
-
-  return 0
-}
-
 print_usage() {
   cat <<EOF
 Usage: $(basename "$0") [options]
@@ -823,11 +772,22 @@ ensure_core_tools() {
     fail "openssl is required."
     exit 1
   fi
+}
+
+has_packaged_bridge_binary() {
+  node "$SCRIPT_DIR/bridge-binary.js" has-current-packaged >/dev/null 2>&1
+}
 
+ensure_local_rust_build_toolchain() {
   if ! ensure_or_install_command "cc" "C compiler/linker (cc)" install_c_toolchain_cli "Y"; then
     fail "C compiler/linker is required for Rust crate builds."
     exit 1
   fi
+
+  if ! ensure_or_install_command "cargo" "Rust/Cargo toolchain" install_rust_toolchain "Y"; then
+    fail "Rust/Cargo is required for the rust bridge."
+    exit 1
+  fi
 }
 
 ensure_codex_cli() {
@@ -1245,137 +1205,6 @@ install_project_dependencies() {
   fi
 }
 
-cleanup_bridge() {
-  if [[ "$KEEP_SERVICES_RUNNING" == "true" ]]; then
-    return
-  fi
-
-  stop_process_group_by_pattern "Expo" "$EXPO_STOP_PATTERN"
-  stop_process_group_by_pattern "Rust bridge" "$BRIDGE_STOP_PATTERN"
-
-  rm -f "$BRIDGE_PID_FILE" "$EXPO_PID_FILE"
-}
-
-wait_for_bridge_health() {
-  local host="$1"
-  local port="$2"
-  local max_wait_secs="${BRIDGE_HEALTH_WAIT_SECS:-300}"
-  local elapsed=0
-
-  if ! command -v curl >/dev/null 2>&1; then
-    return 0
-  fi
-
-  while true; do
-    if curl --max-time 1 -fsS "http://$host:$port/health" >/dev/null 2>&1; then
-      return 0
-    fi
-
-    if [[ -n "$BRIDGE_PID" ]] && ! kill -0 "$BRIDGE_PID" >/dev/null 2>&1; then
-      return 1
-    fi
-
-    sleep 1
-    elapsed=$((elapsed + 1))
-    if (( elapsed % 5 == 0 )); then
-      info "Waiting for bridge health... ${elapsed}s elapsed"
-    fi
-
-    if (( elapsed >= max_wait_secs )); then
-      return 2
-    fi
-  done
-}
-
-stream_expo_output_until_enter() {
-  local tail_pid=""
-  local _user_input=""
-  local waited=0
-  local max_wait_secs="${EXPO_OUTPUT_WAIT_SECS:-90}"
-  local -a spinner_frames=("-" "\\" "|" "/")
-  local frame="-"
-
-  rail_echo "Expo output is live below."
-  rail_echo "Press Enter to exit onboarding and keep Expo + bridge running (Ctrl+D also detaches)."
-  echo ""
-
-  if [[ ! -s "$EXPO_LOG" ]]; then
-    while true; do
-      if [[ -s "$EXPO_LOG" ]]; then
-        printf "\r\033[2K%s Expo output started.\n" "$RAIL_GLYPH"
-        break
-      fi
-
-      if [[ -n "$EXPO_PID" ]] && ! kill -0 "$EXPO_PID" >/dev/null 2>&1; then
-        printf "\r\033[2K%s Expo process exited before output appeared.\n" "$RAIL_GLYPH"
-        return 1
-      fi
-
-      if (( waited >= max_wait_secs )); then
-        printf "\r\033[2K%s Still waiting for Expo output...\n" "$RAIL_GLYPH"
-        break
-      fi
-
-      frame="${spinner_frames[$((waited % ${#spinner_frames[@]}))]}"
-      printf "\r\033[2K%s Waiting for Expo output %s %ss" "$RAIL_GLYPH" "$frame" "$waited"
-      sleep 1
-      waited=$((waited + 1))
-    done
-  fi
-
-  tail -n +1 -f "$EXPO_LOG" &
-  tail_pid="$!"
-  if ! IFS= read -r _user_input 2>/dev/null; then
-    rail_echo "Input stream closed; detaching onboarding."
-  fi
-  kill -TERM "$tail_pid" >/dev/null 2>&1 || true
-  wait "$tail_pid" 2>/dev/null || true
-  return 0
-}
-
-start_expo_process_background() {
-  local log_file="$1"
-
-  if command -v script >/dev/null 2>&1; then
-    if [[ "$OS_NAME" == "Darwin" ]]; then
-      # Feed script from a never-ending pipe to avoid EOF-triggered Expo shutdown.
-      nohup bash -lc "cd \"$ROOT_DIR\" && tail -f /dev/null | script -q \"$log_file\" npm run \"$EXPO_MODE\"" >/dev/null 2>&1 &
-      EXPO_PID="$!"
-      return 0
-    fi
-
-    # util-linux script uses -c for command mode.
-    nohup bash -lc "cd \"$ROOT_DIR\" && tail -f /dev/null | script -q -f -c \"npm run $EXPO_MODE\" \"$log_file\"" >/dev/null 2>&1 &
-    EXPO_PID="$!"
-    return 0
-  fi
-
-  nohup bash -lc "cd \"$ROOT_DIR\" && npm run \"$EXPO_MODE\"" >"$log_file" 2>&1 </dev/null &
-  EXPO_PID="$!"
-}
-
-start_expo_background() {
-  info "Starting Expo ($EXPO_MODE) in background..."
-  : >"$EXPO_LOG"
-  start_expo_process_background "$EXPO_LOG"
-  echo "$EXPO_PID" > "$EXPO_PID_FILE"
-
-  sleep 1
-  if ! kill -0 "$EXPO_PID" >/dev/null 2>&1; then
-    fail "Expo failed to start. Recent logs:"
-    tail -n 80 "$EXPO_LOG" || true
-    exit 1
-  fi
-
-  KEEP_SERVICES_RUNNING="true"
-  ok "Bridge + Expo are running in background."
-  rail_echo "Bridge logs: $BRIDGE_LOG"
-  rail_echo "Expo logs: $EXPO_LOG"
-  rail_echo "To stop later:"
-  rail_echo "pkill -TERM -f '$EXPO_STOP_PATTERN'; pkill -TERM -f '$BRIDGE_STOP_PATTERN'"
-  stream_expo_output_until_enter
-}
-
 start_bridge_foreground() {
   rail_echo "Starting bridge in foreground."
   rail_echo "Press Ctrl+C to stop the bridge."
@@ -1406,9 +1235,11 @@ choose_flow
 
 section "Prerequisites"
 ensure_core_tools
-if ! ensure_or_install_command "cargo" "Rust/Cargo toolchain" install_rust_toolchain "Y"; then
-  fail "Rust/Cargo is required for the rust bridge."
-  exit 1
+if has_packaged_bridge_binary; then
+  ok "Found packaged Rust bridge binary for this host."
+else
+  info "No packaged bridge binary found for this host. Falling back to local Rust build."
+  ensure_local_rust_build_toolchain
 fi
 ensure_codex_cli
 install_project_dependencies
@@ -1517,6 +1348,6 @@ fi
 
 section "Next steps"
 rail_echo "1) cd $ROOT_DIR && npm run secure:bridge"
-rail_echo "2) Open the iOS app and use onboarding to connect (mode + URL + token QR)."
+rail_echo "2) Open the mobile app and use onboarding to connect (URL + token QR)."
 rail_blank
 rail_echo "${DIM}You can rerun this anytime: npm run setup:wizard${RESET}"