rechrome 1.28.1 → 1.29.0

package/README.md

@@ -88,13 +88,14 @@ On the host (the machine with Chrome):
 rech listener add share --listen local --prefix=rechrome --port 13776 --profile you@example.com
 tailscale serve --bg --set-path=/rechrome 13776
 rech listener set share --public-url https://host.example.ts.net/rechrome/
-rech url you@example.com --listener share        # prints the URL to share — it contains a secret key
+rech share you@example.com                       # prints the URL to share — it contains a secret key
 ```
 
 `rech listener add` prints these follow-up lines with your port filled in. For scripts,
 `rech listener port share` prints the port (`$(rech listener port share)` in bash or PowerShell).
 
-On the other machine, inside the project that should use it:
+On the other machine, inside the project that should use it (or just open the link in a
+browser: it shows these commands, per shell, with a Copy button):
 
 ```bash
 rech connect 'https://host.example.ts.net/rechrome/?profile=you%40example.com#key=…'
@@ -106,13 +107,13 @@ rech open https://example.com
 interactions, but not `eval`/`run-code` or filesystem commands (see [Remote access](#remote-access)).
 
 On a trusted LAN without a proxy, `rech setup --listen lan --profile you@example.com` binds the
-profile to your LAN address directly (plain HTTP); share the result of `rech url`.
+profile to your LAN address directly (plain HTTP); share the result of `rech share`.
 
 ### 5. Manage access
 
 ```bash
-rech url ls                                   # every listener × profile, local and public URLs (keys hidden)
-rech url you@example.com --listener share     # print one URL again (add --save to use it in this project)
+rech share ls                                 # everything shared: listener × profile, local and public URLs (keys hidden)
+rech share you@example.com                    # print one URL again (add --save to use it in this project)
 rech listener allow share teammate@example.com
 rech listener deny share teammate@example.com
 rech listener rotate-key share                # revoke: every URL for this listener stops working
@@ -193,7 +194,7 @@ Connection parameters also accept URL fragments:
 RECHROME_URL='https://your-host.ts.net/rechrome/?profile=qa#key=DAEMON_KEY' rech status
 ```
 
-`rech setup` prints and saves this URI format. Retrieve it later with `rech url qa` (alias: `rech profile qa --print-uri`), or omit `qa` to use the configured profile. `profiles` remains an alias. The command prints only the URI to stdout, using the configured `RECHROME_URL` endpoint; `--listener local` selects a local listener instead. For example: `rech profile qa --print-uri --listener local`. The output contains a secret daemon key.
+`rech setup` prints and saves this URI format. Retrieve it later with `rech share qa` (alias: `rech profile qa --print-uri`), or omit `qa` to use the configured profile. `profiles` remains an alias. The command prints only the URI to stdout, using the configured `RECHROME_URL` endpoint; `--listener local` selects a local listener instead. For example: `rech profile qa --print-uri --listener local`. The output contains a secret daemon key.
 
 Direct connections use the root path, such as `http://127.0.0.1:13775/?profile=qa#key=DAEMON_KEY`. A prefix is optional and only added when explicitly configured with `--prefix`, for example for a proxy mounted at `/rechrome/`. Tailscale can also serve at the root without a prefix.
 
@@ -207,7 +208,7 @@ cp .env.example .env.local
 
 | Variable                            | Description                                                                                                                         | Default          |
 | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
-| `RECHROME_URL`                      | Connection URL, saved by `rech setup` / `rech connect` / `rech url --save`. Also accepts `?extension_id=`, `?token=`, `?profile=` query params | —                |
+| `RECHROME_URL`                      | Connection URL, saved by `rech setup` / `rech connect` / `rech share --save`. Also accepts `?extension_id=`, `?token=`, `?profile=` query params | —                |
 | `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`                         | Legacy bind address, used only before listeners.json is configured                                                                  | `127.0.0.1`      |
 | `PLAYWRIGHT_MCP_EXTENSION_ID`       | Chrome extension ID (client overrides server)                                                                                       | —                |

package/daemon-manager.js

@@ -24,13 +24,14 @@ function oxmgrHasWinfix(version) {
 function pickDaemonManager(opts) {
   const override = opts.override?.toLowerCase();
   if (override === "oxmgr" && !opts.oxmgrBin) {
-    throw new Error("RECH_DAEMON_MANAGER=oxmgr, but oxmgr is not on PATH. Install oxmgr and add it to PATH, or install pm2 with `bun add -g pm2` and set RECH_DAEMON_MANAGER=pm2.");
+    throw new Error("RECH_DAEMON_MANAGER=oxmgr, but oxmgr is not on PATH. Install it with `bun i -g oxmgr` and ensure the global bin directory is on PATH.");
   }
   if (override === "pm2" && !opts.pm2Bin) {
     throw new Error("RECH_DAEMON_MANAGER=pm2, but pm2 is not on PATH. Install it with `bun add -g pm2` and ensure the global bin directory is on PATH.");
   }
   if (!opts.oxmgrBin && !opts.pm2Bin) {
-    throw new Error("No daemon process manager found on PATH (oxmgr or pm2). Install pm2 with `bun add -g pm2`, ensure the global bin directory is on PATH, then rerun `bunx rechrome setup`.");
+    const install = opts.isWindows ? "Install oxmgr with `bun i -g oxmgr` (on Windows, pm2 via `bun add -g pm2` is preferred unless oxmgr is the +winfix build)" : "Install oxmgr with `bun i -g oxmgr`";
+    throw new Error(`No daemon process manager found on PATH (oxmgr or pm2). ${install}, ensure the global bin directory is on PATH, then rerun \`bunx rechrome setup\`.`);
   }
   const oxmgr = { id: "oxmgr", bin: opts.oxmgrBin ?? "oxmgr" };
   const pm2 = { id: "pm2", bin: opts.pm2Bin ?? "pm2" };
@@ -62,9 +63,27 @@ function oxmgrInstallCommand(env) {
     return ["npm", "i", "-g", "oxmgr"];
   return ["bun", "i", "-g", "oxmgr"];
 }
+var PM2_DEPRECATION = "pm2 is deprecated as the rech daemon manager; install oxmgr (`bun i -g oxmgr`) and rerun `rech setup` to migrate.";
+function isDeprecatedPm2Fallback(mgr, opts) {
+  return mgr.id === "pm2" && !opts.isWindows && !opts.override;
+}
+function listsProcess(id, output, name) {
+  if (id === "pm2") {
+    try {
+      const list = JSON.parse(output);
+      return Array.isArray(list) && list.some((p) => p?.name === name);
+    } catch {
+      return false;
+    }
+  }
+  return output.split(/[\s\u2502|\u2503]+/).includes(name);
+}
 export {
   OXMGR_WINFIX_BASE,
+  PM2_DEPRECATION,
   compareVersion,
+  isDeprecatedPm2Fallback,
+  listsProcess,
   oxmgrHasWinfix,
   oxmgrInstallCommand,
   pickDaemonManager

package/daemon-manager.ts

@@ -58,13 +58,18 @@ export function pickDaemonManager(opts: {
 }): DaemonManager {
   const override = opts.override?.toLowerCase();
   if (override === "oxmgr" && !opts.oxmgrBin) {
-    throw new Error("RECH_DAEMON_MANAGER=oxmgr, but oxmgr is not on PATH. Install oxmgr and add it to PATH, or install pm2 with `bun add -g pm2` and set RECH_DAEMON_MANAGER=pm2.");
+    throw new Error("RECH_DAEMON_MANAGER=oxmgr, but oxmgr is not on PATH. Install it with `bun i -g oxmgr` and ensure the global bin directory is on PATH.");
   }
   if (override === "pm2" && !opts.pm2Bin) {
     throw new Error("RECH_DAEMON_MANAGER=pm2, but pm2 is not on PATH. Install it with `bun add -g pm2` and ensure the global bin directory is on PATH.");
   }
   if (!opts.oxmgrBin && !opts.pm2Bin) {
-    throw new Error("No daemon process manager found on PATH (oxmgr or pm2). Install pm2 with `bun add -g pm2`, ensure the global bin directory is on PATH, then rerun `bunx rechrome setup`.");
+    // oxmgr is the recommended manager. On Windows stock oxmgr is only used when pm2 is
+    // absent (see below), so pm2 stays a documented alternative there.
+    const install = opts.isWindows
+      ? "Install oxmgr with `bun i -g oxmgr` (on Windows, pm2 via `bun add -g pm2` is preferred unless oxmgr is the +winfix build)"
+      : "Install oxmgr with `bun i -g oxmgr`";
+    throw new Error(`No daemon process manager found on PATH (oxmgr or pm2). ${install}, ensure the global bin directory is on PATH, then rerun \`bunx rechrome setup\`.`);
   }
   const oxmgr: DaemonManager = { id: "oxmgr", bin: opts.oxmgrBin ?? "oxmgr" };
   const pm2: DaemonManager = { id: "pm2", bin: opts.pm2Bin ?? "pm2" };
@@ -97,3 +102,29 @@ export function oxmgrInstallCommand(env: { npm_config_user_agent?: string; npm_e
   if (/(^|\/)(npm|npx)(-cli\.js|\.cmd|\.exe)?$/i.test(execPath)) return ["npm", "i", "-g", "oxmgr"];
   return ["bun", "i", "-g", "oxmgr"];
 }
+
+export const PM2_DEPRECATION =
+  "pm2 is deprecated as the rech daemon manager; install oxmgr (`bun i -g oxmgr`) and rerun `rech setup` to migrate.";
+
+// Whether `mgr` is pm2 only as a stopgap because oxmgr is missing: the case where the user
+// should be nudged to oxmgr. Never on Windows, where pm2 is the deliberate choice over stock
+// (non-winfix) oxmgr and installing oxmgr would not change the pick, and never for an explicit
+// RECH_DAEMON_MANAGER=pm2.
+export function isDeprecatedPm2Fallback(mgr: DaemonManager, opts: { isWindows: boolean; override?: string | null }): boolean {
+  return mgr.id === "pm2" && !opts.isWindows && !opts.override;
+}
+
+// Whether a manager's process list (pm2 `jlist` JSON / oxmgr `list` table) registers exactly
+// `name`. A substring test false-positives on other processes whose names, paths or args
+// mention it (a pm2 app running from a `.../rechrome/...` checkout, or legacy `rechrome-serve`).
+export function listsProcess(id: DaemonManager["id"], output: string, name: string): boolean {
+  if (id === "pm2") {
+    try {
+      const list = JSON.parse(output);
+      return Array.isArray(list) && list.some((p: { name?: unknown } | null) => p?.name === name);
+    } catch {
+      return false;
+    }
+  }
+  return output.split(/[\s│|┃]+/).includes(name);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rechrome",
-  "version": "1.28.1",
+  "version": "1.29.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/snomiao/rechrome.git"