rechrome 1.18.1 → 1.20.0

package/README.md

@@ -16,9 +16,14 @@ Built on top of [playwright-multi-tab](https://github.com/snomiao/playwright-mul
 ## Prerequisites
 
 - [Bun](https://bun.sh/) ≥ 1.0
-- [playwright-cli](https://www.npmjs.com/package/playwright-cli) (works out of the box)
 
-> **💡 Recommended:** For full multi-tab and multi-session support, install [playwright-multi-tab](https://github.com/snomiao/playwright-multi-tab) and set `PLAYWRIGHT_CLI=playwright-cli-multi-tab` in your `.env.local`.
+The patched multi-tab playwright CLI that drives Chrome (with multi-tab, multi-session, and
+per-profile `PLAYWRIGHT_MCP_PROFILE_DIRECTORY` support) is **bundled inside the package** — no
+separate install, no `playwright` browser-binary download. `bun i -g rechrome` is enough for
+`rechrome setup` to work out of the box.
+
+> **Advanced:** override the bundled CLI with `PLAYWRIGHT_CLI=<cmd>` in your `.env.local` (e.g. to
+> point at a local checkout of the [playwright-cli fork](https://github.com/snomiao/playwright-cli)).
 
 ## Install
 
@@ -113,7 +118,7 @@ cp .env.example .env.local
 | Variable                            | Description                                                                                                                         | Default          |
 | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
 | `RECHROME_URL`                      | Connection URL (auto-generated by `rech serve`). Also accepts `?extension_id=`, `?token=`, `?profile=` query params                 | —                |
-| `PLAYWRIGHT_CLI`                    | Path to playwright-cli binary (recommended: `playwright-cli-multi-tab` for full multi-tab support)                                  | `playwright-cli` |
+| `PLAYWRIGHT_CLI`                    | Override the playwright-cli command/path (defaults to the bundled `@playwright/cli`; set this only for a custom or forked CLI)       | bundled `@playwright/cli` |
 | `RECH_HOST`                         | Server bind address                                                                                                                 | `127.0.0.1`      |
 | `PLAYWRIGHT_MCP_EXTENSION_ID`       | Chrome extension ID (client overrides server)                                                                                       | —                |
 | `PLAYWRIGHT_MCP_EXTENSION_TOKEN`    | Chrome extension token — profile-specific, get it from the extension's status page (client overrides server)                        | —                |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rechrome",
-  "version": "1.18.1",
+  "version": "1.20.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/snomiao/rechrome.git"
@@ -17,13 +17,15 @@
     "rech.js",
     "rech.ts",
     "serve.js",
-    "serve.ts"
+    "serve.ts",
+    "vendor"
   ],
   "type": "module",
   "scripts": {
     "serve": "bun run rech.ts serve",
     "test": "bun test",
-    "prepublishOnly": "sed 's/\\.ts/\\.js/g' rech.ts > rech.js && sed 's/\\.ts/\\.js/g' serve.ts > serve.js"
+    "vendor-cli": "bash scripts/vendor-cli.sh",
+    "prepublishOnly": "bash scripts/vendor-cli.sh && sed 's/\\.ts/\\.js/g' rech.ts > rech.js && sed 's/\\.ts/\\.js/g' serve.ts > serve.js"
   },
   "devDependencies": {
     "@types/bun": "latest"

package/rech.js

@@ -5,6 +5,7 @@ import { randomBytes } from "crypto";
 import { mkdirSync, appendFileSync, existsSync, realpathSync, accessSync, cpSync, unlinkSync, readFileSync, readdirSync, constants as fsConstants } from "fs";
 import { hostname, homedir } from "os";
 import { join, basename, dirname } from "path";
+import { spawn as cpSpawn } from "child_process";
 
 export const ENV_KEY = "RECHROME_URL";
 export const DEFAULT_PORT = 13775;
@@ -602,6 +603,27 @@ async function pmList(): Promise<string> {
   return await new Response(proc.stdout).text();
 }
 
+// Resolve which playwright-cli the daemon runs to drive Chrome. Priority:
+//   1. PLAYWRIGHT_CLI env override — explicit, already a full command string.
+//   2. Vendored fork in a git checkout (lib/playwright-cli/playwright-cli.js) — the patched
+//      multi-tab CLI + patched playwright-core (PLAYWRIGHT_MCP_PROFILE_DIRECTORY etc.).
+//   3. The fork bundled into the npm tarball (vendor/playwright-cli/playwright-cli.js, produced by
+//      scripts/vendor-cli.sh at prepublish). This is the batteries-included default for
+//      `bun i -g rechrome`: self-contained, no @playwright/cli dep, no browser-binary download.
+//   4. Bare `playwright-cli-multi-tab` on PATH — legacy fallback for a pre-existing global link.
+// A resolved .js entry is run through `node` on Windows (which can't exec a .js by shebang) and
+// bare on POSIX (its `#!/usr/bin/env node` shebang runs it under node, which the relay handshake
+// needs — see daemonInstall). serve splits the result on spaces into argv.
+export function resolvePlaywrightCli(): string {
+  if (process.env.PLAYWRIGHT_CLI) return process.env.PLAYWRIGHT_CLI;
+  const jsEntry = [
+    join(import.meta.dir, "lib/playwright-cli/playwright-cli.js"),
+    join(import.meta.dir, "vendor/playwright-cli/playwright-cli.js"),
+  ].find(existsSync);
+  if (jsEntry) return IS_WINDOWS ? `node ${jsEntry}` : jsEntry;
+  return "playwright-cli-multi-tab";
+}
+
 export async function daemonInstall(serveUrl: string): Promise<void> {
   // Persist the URL to ~/.env.local before starting the daemon. The daemon's
   // loadEnv() walks CWD→root reading .env.local files and unconditionally
@@ -618,20 +640,14 @@ export async function daemonInstall(serveUrl: string): Promise<void> {
   const bunBin = Bun.which("bun") ?? process.execPath;
   const rechScript = import.meta.filename;
 
-  // Resolve PLAYWRIGHT_CLI: env override > bundled fork (development checkout) > "playwright-cli-multi-tab".
-  // The fork is a .js script: POSIX execs it via its shebang (`#!/usr/bin/env node`), but Windows
-  // can't exec a .js directly, so it must be invoked through an interpreter. It MUST be node, not
-  // bun: the cliDaemon inherits its parent's runtime (spawned via process.execPath), and the
+  // Resolve PLAYWRIGHT_CLI (see resolvePlaywrightCli). The resolved .js entry MUST run under node,
+  // not bun: the cliDaemon inherits its parent's runtime (spawned via process.execPath), and the
   // extension-bridge relay's WebSocket handshake hangs under Bun (the extension WS connects but
   // `extension.initialized` never completes) — under node it completes, matching the POSIX shebang.
-  // serve splits PLAYWRIGHT_CLI on spaces into argv, so we use bare `node` (the node path lives
-  // under "Program Files" and contains a space); node must be on the daemon's PATH, same as the
-  // shebang's `env node` assumption. The repo path contains no spaces.
-  const bundledForkCli = join(import.meta.dir, "lib/playwright-cli/playwright-cli.js");
-  const resolvedPlaywrightCli = process.env.PLAYWRIGHT_CLI
-    || (existsSync(bundledForkCli)
-        ? (IS_WINDOWS ? `node ${bundledForkCli}` : bundledForkCli)
-        : "playwright-cli-multi-tab");
+  // serve splits PLAYWRIGHT_CLI on spaces into argv, so on Windows we use bare `node` (the node
+  // path lives under "Program Files" and contains a space); node must be on the daemon's PATH, same
+  // as the shebang's `env node` assumption. The repo / install paths contain no spaces.
+  const resolvedPlaywrightCli = resolvePlaywrightCli();
 
   // Environment the managed `serve` process must run with.
   const daemonEnv: Record<string, string> = {
@@ -685,6 +701,87 @@ async function daemonUninstall(): Promise<void> {
   console.log(`Removed ${PM_BIN} process: ${PM_PROCESS_NAME}`);
 }
 
+// ── Native tray (menu-bar / system-tray) icon ───────────────────────────────
+// The tray is a small native binary (tray/, Rust). `rech` just supervises it:
+// locate the binary and launch it detached (singleton via a pidfile).
+// `rech tray hide` / the menu "Hide" item both kill the process;
+// `rech tray show` starts a fresh one.
+const TRAY_PID_FILE = join(RECH_HOME_DIR, "tray.pid");
+
+// A desktop GUI must be present. Linux needs an X11/Wayland display; a headless
+// box (SSH, CI, container) has neither, so the tray is skipped. macOS/Windows
+// desktop sessions effectively always have one (the binary bypasses if not).
+function trayGuiAvailable(): boolean {
+  if (process.platform === "linux")
+    return !!(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
+  return true;
+}
+
+// Resolve the tray binary: explicit override, then the copy shipped beside
+// `rech` (packaged installs), then the dev cargo build, then PATH.
+function findTrayBinary(): string | undefined {
+  const ext = IS_WINDOWS ? ".exe" : "";
+  const candidates = [
+    process.env.RECH_TRAY_BIN,
+    join(import.meta.dir, "tray", `rechrome-tray${ext}`),
+    join(import.meta.dir, "tray", "target", "release", `rechrome-tray${ext}`),
+    join(import.meta.dir, "tray", "target", "debug", `rechrome-tray${ext}`),
+  ].filter(Boolean) as string[];
+  for (const c of candidates) if (existsSync(c)) return c;
+  return Bun.which(`rechrome-tray${ext}`) ?? undefined;
+}
+
+function isTrayRunning(): boolean {
+  try {
+    const pid = parseInt(readFileSync(TRAY_PID_FILE, "utf8"), 10);
+    if (!Number.isFinite(pid)) return false;
+    process.kill(pid, 0); // signal 0 = liveness probe, doesn't actually signal
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Start (and "show") the tray. quiet=true is used by `rech setup` auto-start so
+// a missing binary / headless box stays silent rather than noisy.
+async function startTray({ quiet = false }: { quiet?: boolean } = {}): Promise<void> {
+  if (!trayGuiAvailable()) {
+    if (!quiet) console.log("tray: no desktop GUI session detected — skipped.");
+    return;
+  }
+  if (isTrayRunning()) {
+    if (!quiet) console.log("tray: already running.");
+    return;
+  }
+  const bin = findTrayBinary();
+  if (!bin) {
+    if (!quiet)
+      console.error("tray: binary not found. Build it with:  (cd tray && cargo build --release)");
+    return;
+  }
+  const child = cpSpawn(bin, [], { detached: true, stdio: "ignore" });
+  child.unref(); // outlive this CLI invocation
+  if (child.pid) await Bun.write(TRAY_PID_FILE, String(child.pid));
+  if (!quiet) console.log(`tray: started (pid ${child.pid}).`);
+}
+
+function stopTray(): void {
+  if (!isTrayRunning()) { console.log("tray: not running."); return; }
+  try { process.kill(parseInt(readFileSync(TRAY_PID_FILE, "utf8"), 10)); } catch {}
+  try { unlinkSync(TRAY_PID_FILE); } catch {}
+  console.log("tray: stopped. Run `rech tray show` to restore.");
+}
+
+async function trayCommand(sub?: string): Promise<void> {
+  switch (sub) {
+    case "hide": case "stop": case "quit": stopTray(); break;
+    case undefined: case "": case "show": case "start": await startTray(); break;
+    default:
+      console.error(`Unknown tray command: "${sub}". Usage: rech tray [show|hide|stop]`);
+      process.exit(1);
+  }
+}
+
 // Read the extension's auth token straight from a profile's localStorage LevelDB. Read-only
 // (we never take LevelDB's lock), so it's safe while the user's Chrome is running. The token is
 // the value of the `auth-token` key under the extension origin, stored as a 0x01 (Latin-1)
@@ -1292,6 +1389,9 @@ Usage:
                                --load-extension, so this is a clean browser, not your
                                real Chrome. For your real Chrome, use \`rech setup\`
   rech status                  Show current configuration and serve health
+  rech tray [show|hide|stop]   Native menu-bar/tray icon for the serve daemon
+                               (show=start, hide/show toggle, stop=quit). Auto-
+                               starts after \`rech setup\`; skipped with no GUI
   rech uninstall               Remove the serve daemon and clear config
   rech serve                   Start the serve server manually (foreground)
   rech profiles                List Chrome profiles
@@ -1333,6 +1433,11 @@ if (import.meta.main) {
       : args.find(a => a.startsWith("--token="))?.slice("--token=".length))
       ?? process.env.RECH_TOKEN;
     await setup({ profile, token }); // setup closes envWatcher itself before printing Done
+    // Auto-start the tray (best-effort, silent on headless / missing binary).
+    await startTray({ quiet: true }).catch(() => {});
+  } else if (cmd === "tray") {
+    await trayCommand(args[1]?.toLowerCase());
+    envWatcher?.close();
   } else if (cmd === "provision-profile") {
     const name = args.find((a, i) => i > 0 && !a.startsWith("-"));
     const headed = args.includes("--headed");

package/rech.ts

@@ -5,6 +5,7 @@ import { randomBytes } from "crypto";
 import { mkdirSync, appendFileSync, existsSync, realpathSync, accessSync, cpSync, unlinkSync, readFileSync, readdirSync, constants as fsConstants } from "fs";
 import { hostname, homedir } from "os";
 import { join, basename, dirname } from "path";
+import { spawn as cpSpawn } from "child_process";
 
 export const ENV_KEY = "RECHROME_URL";
 export const DEFAULT_PORT = 13775;
@@ -602,6 +603,27 @@ async function pmList(): Promise<string> {
   return await new Response(proc.stdout).text();
 }
 
+// Resolve which playwright-cli the daemon runs to drive Chrome. Priority:
+//   1. PLAYWRIGHT_CLI env override — explicit, already a full command string.
+//   2. Vendored fork in a git checkout (lib/playwright-cli/playwright-cli.js) — the patched
+//      multi-tab CLI + patched playwright-core (PLAYWRIGHT_MCP_PROFILE_DIRECTORY etc.).
+//   3. The fork bundled into the npm tarball (vendor/playwright-cli/playwright-cli.js, produced by
+//      scripts/vendor-cli.sh at prepublish). This is the batteries-included default for
+//      `bun i -g rechrome`: self-contained, no @playwright/cli dep, no browser-binary download.
+//   4. Bare `playwright-cli-multi-tab` on PATH — legacy fallback for a pre-existing global link.
+// A resolved .js entry is run through `node` on Windows (which can't exec a .js by shebang) and
+// bare on POSIX (its `#!/usr/bin/env node` shebang runs it under node, which the relay handshake
+// needs — see daemonInstall). serve splits the result on spaces into argv.
+export function resolvePlaywrightCli(): string {
+  if (process.env.PLAYWRIGHT_CLI) return process.env.PLAYWRIGHT_CLI;
+  const jsEntry = [
+    join(import.meta.dir, "lib/playwright-cli/playwright-cli.js"),
+    join(import.meta.dir, "vendor/playwright-cli/playwright-cli.js"),
+  ].find(existsSync);
+  if (jsEntry) return IS_WINDOWS ? `node ${jsEntry}` : jsEntry;
+  return "playwright-cli-multi-tab";
+}
+
 export async function daemonInstall(serveUrl: string): Promise<void> {
   // Persist the URL to ~/.env.local before starting the daemon. The daemon's
   // loadEnv() walks CWD→root reading .env.local files and unconditionally
@@ -618,20 +640,14 @@ export async function daemonInstall(serveUrl: string): Promise<void> {
   const bunBin = Bun.which("bun") ?? process.execPath;
   const rechScript = import.meta.filename;
 
-  // Resolve PLAYWRIGHT_CLI: env override > bundled fork (development checkout) > "playwright-cli-multi-tab".
-  // The fork is a .js script: POSIX execs it via its shebang (`#!/usr/bin/env node`), but Windows
-  // can't exec a .js directly, so it must be invoked through an interpreter. It MUST be node, not
-  // bun: the cliDaemon inherits its parent's runtime (spawned via process.execPath), and the
+  // Resolve PLAYWRIGHT_CLI (see resolvePlaywrightCli). The resolved .js entry MUST run under node,
+  // not bun: the cliDaemon inherits its parent's runtime (spawned via process.execPath), and the
   // extension-bridge relay's WebSocket handshake hangs under Bun (the extension WS connects but
   // `extension.initialized` never completes) — under node it completes, matching the POSIX shebang.
-  // serve splits PLAYWRIGHT_CLI on spaces into argv, so we use bare `node` (the node path lives
-  // under "Program Files" and contains a space); node must be on the daemon's PATH, same as the
-  // shebang's `env node` assumption. The repo path contains no spaces.
-  const bundledForkCli = join(import.meta.dir, "lib/playwright-cli/playwright-cli.js");
-  const resolvedPlaywrightCli = process.env.PLAYWRIGHT_CLI
-    || (existsSync(bundledForkCli)
-        ? (IS_WINDOWS ? `node ${bundledForkCli}` : bundledForkCli)
-        : "playwright-cli-multi-tab");
+  // serve splits PLAYWRIGHT_CLI on spaces into argv, so on Windows we use bare `node` (the node
+  // path lives under "Program Files" and contains a space); node must be on the daemon's PATH, same
+  // as the shebang's `env node` assumption. The repo / install paths contain no spaces.
+  const resolvedPlaywrightCli = resolvePlaywrightCli();
 
   // Environment the managed `serve` process must run with.
   const daemonEnv: Record<string, string> = {
@@ -685,6 +701,87 @@ async function daemonUninstall(): Promise<void> {
   console.log(`Removed ${PM_BIN} process: ${PM_PROCESS_NAME}`);
 }
 
+// ── Native tray (menu-bar / system-tray) icon ───────────────────────────────
+// The tray is a small native binary (tray/, Rust). `rech` just supervises it:
+// locate the binary and launch it detached (singleton via a pidfile).
+// `rech tray hide` / the menu "Hide" item both kill the process;
+// `rech tray show` starts a fresh one.
+const TRAY_PID_FILE = join(RECH_HOME_DIR, "tray.pid");
+
+// A desktop GUI must be present. Linux needs an X11/Wayland display; a headless
+// box (SSH, CI, container) has neither, so the tray is skipped. macOS/Windows
+// desktop sessions effectively always have one (the binary bypasses if not).
+function trayGuiAvailable(): boolean {
+  if (process.platform === "linux")
+    return !!(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
+  return true;
+}
+
+// Resolve the tray binary: explicit override, then the copy shipped beside
+// `rech` (packaged installs), then the dev cargo build, then PATH.
+function findTrayBinary(): string | undefined {
+  const ext = IS_WINDOWS ? ".exe" : "";
+  const candidates = [
+    process.env.RECH_TRAY_BIN,
+    join(import.meta.dir, "tray", `rechrome-tray${ext}`),
+    join(import.meta.dir, "tray", "target", "release", `rechrome-tray${ext}`),
+    join(import.meta.dir, "tray", "target", "debug", `rechrome-tray${ext}`),
+  ].filter(Boolean) as string[];
+  for (const c of candidates) if (existsSync(c)) return c;
+  return Bun.which(`rechrome-tray${ext}`) ?? undefined;
+}
+
+function isTrayRunning(): boolean {
+  try {
+    const pid = parseInt(readFileSync(TRAY_PID_FILE, "utf8"), 10);
+    if (!Number.isFinite(pid)) return false;
+    process.kill(pid, 0); // signal 0 = liveness probe, doesn't actually signal
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Start (and "show") the tray. quiet=true is used by `rech setup` auto-start so
+// a missing binary / headless box stays silent rather than noisy.
+async function startTray({ quiet = false }: { quiet?: boolean } = {}): Promise<void> {
+  if (!trayGuiAvailable()) {
+    if (!quiet) console.log("tray: no desktop GUI session detected — skipped.");
+    return;
+  }
+  if (isTrayRunning()) {
+    if (!quiet) console.log("tray: already running.");
+    return;
+  }
+  const bin = findTrayBinary();
+  if (!bin) {
+    if (!quiet)
+      console.error("tray: binary not found. Build it with:  (cd tray && cargo build --release)");
+    return;
+  }
+  const child = cpSpawn(bin, [], { detached: true, stdio: "ignore" });
+  child.unref(); // outlive this CLI invocation
+  if (child.pid) await Bun.write(TRAY_PID_FILE, String(child.pid));
+  if (!quiet) console.log(`tray: started (pid ${child.pid}).`);
+}
+
+function stopTray(): void {
+  if (!isTrayRunning()) { console.log("tray: not running."); return; }
+  try { process.kill(parseInt(readFileSync(TRAY_PID_FILE, "utf8"), 10)); } catch {}
+  try { unlinkSync(TRAY_PID_FILE); } catch {}
+  console.log("tray: stopped. Run `rech tray show` to restore.");
+}
+
+async function trayCommand(sub?: string): Promise<void> {
+  switch (sub) {
+    case "hide": case "stop": case "quit": stopTray(); break;
+    case undefined: case "": case "show": case "start": await startTray(); break;
+    default:
+      console.error(`Unknown tray command: "${sub}". Usage: rech tray [show|hide|stop]`);
+      process.exit(1);
+  }
+}
+
 // Read the extension's auth token straight from a profile's localStorage LevelDB. Read-only
 // (we never take LevelDB's lock), so it's safe while the user's Chrome is running. The token is
 // the value of the `auth-token` key under the extension origin, stored as a 0x01 (Latin-1)
@@ -1292,6 +1389,9 @@ Usage:
                                --load-extension, so this is a clean browser, not your
                                real Chrome. For your real Chrome, use \`rech setup\`
   rech status                  Show current configuration and serve health
+  rech tray [show|hide|stop]   Native menu-bar/tray icon for the serve daemon
+                               (show=start, hide/show toggle, stop=quit). Auto-
+                               starts after \`rech setup\`; skipped with no GUI
   rech uninstall               Remove the serve daemon and clear config
   rech serve                   Start the serve server manually (foreground)
   rech profiles                List Chrome profiles
@@ -1333,6 +1433,11 @@ if (import.meta.main) {
       : args.find(a => a.startsWith("--token="))?.slice("--token=".length))
       ?? process.env.RECH_TOKEN;
     await setup({ profile, token }); // setup closes envWatcher itself before printing Done
+    // Auto-start the tray (best-effort, silent on headless / missing binary).
+    await startTray({ quiet: true }).catch(() => {});
+  } else if (cmd === "tray") {
+    await trayCommand(args[1]?.toLowerCase());
+    envWatcher?.close();
   } else if (cmd === "provision-profile") {
     const name = args.find((a, i) => i > 0 && !a.startsWith("-"));
     const headed = args.includes("--headed");

package/serve.js

@@ -10,6 +10,7 @@ import {
   RECH_DIR,
   HOME,
   PASSTHROUGH_ENV_KEYS,
+  resolvePlaywrightCli,
 } from "./rech.js";
 
 const TAILSCALE_BIN = process.env.TAILSCALE_BIN || "/Applications/Tailscale.app/Contents/MacOS/Tailscale";
@@ -233,7 +234,9 @@ export async function serve() {
       });
       const namespacedSession = clientSession ? `${sessionId}-${clientSession}` : sessionId;
 
-      const [bin, ...binArgs] = splitCommand(process.env.PLAYWRIGHT_CLI || "playwright-cli-multi-tab");
+      // daemonInstall bakes PLAYWRIGHT_CLI into the daemon env; resolvePlaywrightCli() is the
+      // fallback for a standalone `serve` (it re-runs the same env > fork > @playwright/cli > legacy chain).
+      const [bin, ...binArgs] = splitCommand(resolvePlaywrightCli());
 
       if (filteredArgs.length === 0) {
         filteredArgs.push("--help");

package/serve.ts

@@ -10,6 +10,7 @@ import {
   RECH_DIR,
   HOME,
   PASSTHROUGH_ENV_KEYS,
+  resolvePlaywrightCli,
 } from "./rech.ts";
 
 const TAILSCALE_BIN = process.env.TAILSCALE_BIN || "/Applications/Tailscale.app/Contents/MacOS/Tailscale";
@@ -233,7 +234,9 @@ export async function serve() {
       });
       const namespacedSession = clientSession ? `${sessionId}-${clientSession}` : sessionId;
 
-      const [bin, ...binArgs] = splitCommand(process.env.PLAYWRIGHT_CLI || "playwright-cli-multi-tab");
+      // daemonInstall bakes PLAYWRIGHT_CLI into the daemon env; resolvePlaywrightCli() is the
+      // fallback for a standalone `serve` (it re-runs the same env > fork > @playwright/cli > legacy chain).
+      const [bin, ...binArgs] = splitCommand(resolvePlaywrightCli());
 
       if (filteredArgs.length === 0) {
         filteredArgs.push("--help");

package/vendor/playwright-cli/node_modules/playwright-core/README.md

@@ -0,0 +1,3 @@
+# playwright-core
+
+This package contains the no-browser flavor of [Playwright](http://github.com/microsoft/playwright).

package/vendor/playwright-cli/node_modules/playwright-core/ThirdPartyNotices.txt

@@ -0,0 +1,13 @@
+microsoft/playwright-core
+
+THIRD-PARTY SOFTWARE NOTICES AND INFORMATION
+
+This package bundles third-party software inside individual files under
+`lib/`. Each bundled output has a sidecar `<bundle>.js.LICENSE` file next
+to it listing every npm package whose source was inlined into that
+bundle, together with the full license text for each.
+
+For example:
+- lib/utilsBundle.js.LICENSE
+
+This project incorporates components from the projects listed below. The original copyright notices and the licenses under which Microsoft received such components are set forth below. Microsoft reserves all rights not expressly granted herein, whether by implication, estoppel or otherwise.

package/vendor/playwright-cli/node_modules/playwright-core/bin/install_media_pack.ps1

@@ -0,0 +1,5 @@
+$osInfo = Get-WmiObject -Class Win32_OperatingSystem
+# check if running on Windows Server
+if ($osInfo.ProductType -eq 3) {
+  Install-WindowsFeature Server-Media-Foundation
+}

package/vendor/playwright-cli/node_modules/playwright-core/bin/install_webkit_wsl.ps1

@@ -0,0 +1,33 @@
+$ErrorActionPreference = 'Stop'
+
+# This script sets up a WSL distribution that will be used to run WebKit.
+
+$Distribution = "playwright"
+$Username = "pwuser"
+
+$distributions = (wsl --list --quiet) -split "\r?\n"
+if ($distributions -contains $Distribution) {
+    Write-Host "WSL distribution '$Distribution' already exists. Skipping installation."
+} else {
+    Write-Host "Installing new WSL distribution '$Distribution'..."
+    $VhdSize = "10GB"
+    wsl --install -d Ubuntu-24.04 --name $Distribution --no-launch --vhd-size $VhdSize
+    wsl -d $Distribution -u root adduser --gecos GECOS --disabled-password $Username
+}
+
+$pwshDirname = (Resolve-Path -Path $PSScriptRoot).Path;
+$playwrightCoreRoot = Resolve-Path (Join-Path $pwshDirname "..")
+
+$initScript = @"
+if [ ! -f "/home/$Username/node/bin/node" ]; then
+  mkdir -p /home/$Username/node
+  curl -fsSL https://nodejs.org/dist/v22.17.0/node-v22.17.0-linux-x64.tar.xz -o /home/$Username/node/node-v22.17.0-linux-x64.tar.xz
+  tar -xJf /home/$Username/node/node-v22.17.0-linux-x64.tar.xz -C /home/$Username/node --strip-components=1
+  sudo -u $Username echo 'export PATH=/home/$Username/node/bin:\`$PATH' >> /home/$Username/.profile
+fi
+/home/$Username/node/bin/node cli.js install-deps webkit
+sudo -u $Username PLAYWRIGHT_SKIP_BROWSER_GC=1 /home/$Username/node/bin/node cli.js install webkit
+"@ -replace "\r\n", "`n"
+
+wsl -d $Distribution --cd $playwrightCoreRoot -u root -- bash -c "$initScript"
+Write-Host "Done!"

package/vendor/playwright-cli/node_modules/playwright-core/bin/reinstall_chrome_beta_linux.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -e
+set -x
+
+if [[ $(arch) == "aarch64" ]]; then
+  echo "ERROR: not supported on Linux Arm64"
+  exit 1
+fi
+
+if [ -z "$PLAYWRIGHT_HOST_PLATFORM_OVERRIDE" ]; then
+  if [[ ! -f "/etc/os-release" ]]; then
+    echo "ERROR: cannot install on unknown linux distribution (/etc/os-release is missing)"
+    exit 1
+  fi
+
+  ID=$(bash -c 'source /etc/os-release && echo $ID')
+  if [[ "${ID}" != "ubuntu" && "${ID}" != "debian" ]]; then
+    echo "ERROR: cannot install on $ID distribution - only Ubuntu and Debian are supported"
+    exit 1
+  fi
+fi
+
+# 1. make sure to remove old beta if any.
+if dpkg --get-selections | grep -q "^google-chrome-beta[[:space:]]*install$" >/dev/null; then
+  apt-get remove -y google-chrome-beta
+fi
+
+# 2. Update apt lists (needed to install curl and chrome dependencies)
+apt-get update
+
+# 3. Install curl to download chrome
+if ! command -v curl >/dev/null; then
+  apt-get install -y curl
+fi
+
+# 4. download chrome beta from dl.google.com and install it.
+cd /tmp
+curl -O https://dl.google.com/linux/direct/google-chrome-beta_current_amd64.deb
+apt-get install -y ./google-chrome-beta_current_amd64.deb
+rm -rf ./google-chrome-beta_current_amd64.deb
+cd -
+google-chrome-beta --version

package/vendor/playwright-cli/node_modules/playwright-core/bin/reinstall_chrome_beta_mac.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+set -x
+
+rm -rf "/Applications/Google Chrome Beta.app"
+cd /tmp
+curl --retry 3 -o ./googlechromebeta.dmg https://dl.google.com/chrome/mac/universal/beta/googlechromebeta.dmg
+hdiutil attach -nobrowse -quiet -noautofsck -noautoopen -mountpoint /Volumes/googlechromebeta.dmg ./googlechromebeta.dmg
+cp -pR "/Volumes/googlechromebeta.dmg/Google Chrome Beta.app" /Applications
+hdiutil detach /Volumes/googlechromebeta.dmg
+rm -rf /tmp/googlechromebeta.dmg
+
+/Applications/Google\ Chrome\ Beta.app/Contents/MacOS/Google\ Chrome\ Beta --version

package/vendor/playwright-cli/node_modules/playwright-core/bin/reinstall_chrome_beta_win.ps1

@@ -0,0 +1,24 @@
+$ErrorActionPreference = 'Stop'
+
+$url = 'https://dl.google.com/tag/s/dl/chrome/install/beta/googlechromebetastandaloneenterprise64.msi'
+
+Write-Host "Downloading Google Chrome Beta"
+$wc = New-Object net.webclient
+$msiInstaller = "$env:temp\google-chrome-beta.msi"
+$wc.Downloadfile($url, $msiInstaller)
+
+Write-Host "Installing Google Chrome Beta"
+$arguments = "/i `"$msiInstaller`" /quiet"
+Start-Process msiexec.exe -ArgumentList $arguments -Wait
+Remove-Item $msiInstaller
+
+$suffix = "\\Google\\Chrome Beta\\Application\\chrome.exe"
+if (Test-Path "${env:ProgramFiles(x86)}$suffix") {
+    (Get-Item "${env:ProgramFiles(x86)}$suffix").VersionInfo
+} elseif (Test-Path "${env:ProgramFiles}$suffix") {
+    (Get-Item "${env:ProgramFiles}$suffix").VersionInfo
+} else {
+    Write-Host "ERROR: Failed to install Google Chrome Beta."
+    Write-Host "ERROR: This could be due to insufficient privileges, in which case re-running as Administrator may help."
+    exit 1
+}

package/vendor/playwright-cli/node_modules/playwright-core/bin/reinstall_chrome_stable_linux.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -e
+set -x
+
+if [[ $(arch) == "aarch64" ]]; then
+  echo "ERROR: not supported on Linux Arm64"
+  exit 1
+fi
+
+if [ -z "$PLAYWRIGHT_HOST_PLATFORM_OVERRIDE" ]; then
+  if [[ ! -f "/etc/os-release" ]]; then
+    echo "ERROR: cannot install on unknown linux distribution (/etc/os-release is missing)"
+    exit 1
+  fi
+
+  ID=$(bash -c 'source /etc/os-release && echo $ID')
+  if [[ "${ID}" != "ubuntu" && "${ID}" != "debian" ]]; then
+    echo "ERROR: cannot install on $ID distribution - only Ubuntu and Debian are supported"
+    exit 1
+  fi
+fi
+
+# 1. make sure to remove old stable if any.
+if dpkg --get-selections | grep -q "^google-chrome[[:space:]]*install$" >/dev/null; then
+  apt-get remove -y google-chrome
+fi
+
+# 2. Update apt lists (needed to install curl and chrome dependencies)
+apt-get update
+
+# 3. Install curl to download chrome
+if ! command -v curl >/dev/null; then
+  apt-get install -y curl
+fi
+
+# 4. download chrome stable from dl.google.com and install it.
+cd /tmp
+curl -O https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
+apt-get install -y ./google-chrome-stable_current_amd64.deb
+rm -rf ./google-chrome-stable_current_amd64.deb
+cd -
+google-chrome --version

package/vendor/playwright-cli/node_modules/playwright-core/bin/reinstall_chrome_stable_mac.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -e
+set -x
+
+rm -rf "/Applications/Google Chrome.app"
+cd /tmp
+curl --retry 3 -o ./googlechrome.dmg https://dl.google.com/chrome/mac/universal/stable/GGRO/googlechrome.dmg
+hdiutil attach -nobrowse -quiet -noautofsck -noautoopen -mountpoint /Volumes/googlechrome.dmg ./googlechrome.dmg
+cp -pR "/Volumes/googlechrome.dmg/Google Chrome.app" /Applications
+hdiutil detach /Volumes/googlechrome.dmg
+rm -rf /tmp/googlechrome.dmg
+/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --version