rechrome 1.2.0 → 1.4.0

package/.env.example

@@ -1,11 +1,9 @@
 # Remote Chrome connection URL (auto-generated by `rech serve` if not set)
 # REMOTE_CHROME_URL=remote-chrome://key@host:13775
 
-# Gemini API key for screenshot vision descriptions (optional)
-# GEMINI_API_KEY=your-gemini-api-key
-
-# Custom playwright-cli binary path (default: playwright-cli)
-# For full multi-tab & multi-session support, use playwright-cli-multi-tab:
+# Custom playwright-cli binary (default: playwright-cli). Supports space-separated runtime prefix.
+# For global install: PLAYWRIGHT_CLI=playwright-cli-multi-tab
+# For local submodule (with bun): PLAYWRIGHT_CLI=bun ./lib/playwright-cli/playwright-cli.js
 # PLAYWRIGHT_CLI=playwright-cli-multi-tab
 
 # Bind address for the server (default: 127.0.0.1, use 0.0.0.0 for remote access)
@@ -14,3 +12,10 @@
 # Playwright MCP extension settings (can be set on server or client; client overrides server)
 # PLAYWRIGHT_MCP_EXTENSION_ID=your-extension-id
 # PLAYWRIGHT_MCP_EXTENSION_TOKEN=your-extension-token
+
+# Chrome profile to use when connecting via --extension (macOS/Windows multi-profile setups)
+# Set USER_DATA_DIR to Chrome's user data directory, and PROFILE_DIRECTORY to the sub-profile name.
+# macOS default: ~/Library/Application Support/Google/Chrome
+# Profile names: Default, "Profile 1", "Profile 2", etc. (check chrome://version for yours)
+# PLAYWRIGHT_MCP_USER_DATA_DIR=/Users/yourname/Library/Application Support/Google/Chrome
+# PLAYWRIGHT_MCP_PROFILE_DIRECTORY=Profile 2

package/README.md

@@ -10,7 +10,6 @@ Built on top of [playwright-multi-tab](https://github.com/snomiao/playwright-mul
 
 - **Session isolation** — clients are automatically namespaced by git repo or hostname
 - **File transfer** — screenshots and PDFs are automatically downloaded to the client
-- **Vision descriptions** — opt-in Gemini-powered screenshot descriptions (`--gemini-vision`)
 - **Hot-reload config** — `.env.local` changes are picked up without restart
 - **Security** — bearer auth, path traversal protection, env allowlisting for child processes
 
@@ -61,9 +60,6 @@ rechrome open https://example.com
 # Take a screenshot
 rechrome screenshot
 
-# Take a screenshot with Gemini vision description
-rechrome screenshot --gemini-vision
-
 # List open tabs
 rechrome tab-list
 
@@ -82,11 +78,19 @@ cp .env.example .env.local
 | Variable                         | Description                                                                                        | Default          |
 | -------------------------------- | -------------------------------------------------------------------------------------------------- | ---------------- |
 | `REMOTE_CHROME_URL`              | Connection URL (auto-generated by `rechrome serve`)                                                | —                |
-| `GEMINI_API_KEY`                 | Gemini API key for `--gemini-vision` screenshot descriptions                                       | —                |
 | `PLAYWRIGHT_CLI`                 | Path to playwright-cli binary (recommended: `playwright-cli-multi-tab` for full multi-tab support) | `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 (client overrides server)                                                   | —                |
+| `PLAYWRIGHT_MCP_EXTENSION_ID`       | Chrome extension ID (client overrides server)                                                                                   | —                |
+| `PLAYWRIGHT_MCP_EXTENSION_TOKEN`    | Chrome extension token (client overrides server)                                                                                | —                |
+| `PLAYWRIGHT_MCP_USER_DATA_DIR`      | Chrome user data directory — use to pin connections to a specific Chrome install (client overrides server)                      | —                |
+| `PLAYWRIGHT_MCP_PROFILE_DIRECTORY`  | Chrome profile sub-directory (e.g. `Profile 2`) — use when multiple profiles share the same user data dir (client overrides server) | —                |
+
+> **Multi-profile tip:** If you have multiple Chrome profiles open and only one has the Playwright MCP Bridge extension, set both vars so the extension connection always targets the correct profile:
+> ```
+> PLAYWRIGHT_MCP_USER_DATA_DIR=/Users/yourname/Library/Application Support/Google/Chrome
+> PLAYWRIGHT_MCP_PROFILE_DIRECTORY=Profile 2
+> ```
+> To find your profile directory name, open `chrome://version` in the target Chrome profile and look for **Profile Path**.
 
 ### Remote access
 

package/package.json

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

package/rech.js

@@ -35,44 +35,12 @@ if (existsSync(envFile)) {
   });
 }
 
-/** Describe an image using Gemini vision API. Returns description or null on failure. */
-export async function describeImage(imagePath: string): Promise<string | null> {
-  const apiKey = process.env.GEMINI_API_KEY;
-  if (!apiKey) return null;
-  try {
-    const imageData = await file(imagePath).arrayBuffer();
-    const base64 = Buffer.from(imageData).toString("base64");
-    const mimeType = imagePath.endsWith(".png") ? "image/png" : "image/jpeg";
-    const res = await fetch(
-      `https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-pro-preview:generateContent?key=${apiKey}`,
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          contents: [
-            {
-              parts: [
-                {
-                  text: "Describe this browser screenshot concisely in 2-3 sentences. Focus on what's visible: page layout, content, any errors or issues.",
-                },
-                { inline_data: { mime_type: mimeType, data: base64 } },
-              ],
-            },
-          ],
-        }),
-      },
-    );
-    if (!res.ok) return null;
-    const json = await res.json();
-    return json.candidates?.[0]?.content?.parts?.[0]?.text?.trim() ?? null;
-  } catch {
-    return null;
-  }
-}
 
 export const PASSTHROUGH_ENV_KEYS = [
   "PLAYWRIGHT_MCP_EXTENSION_ID",
   "PLAYWRIGHT_MCP_EXTENSION_TOKEN",
+  "PLAYWRIGHT_MCP_USER_DATA_DIR",
+  "PLAYWRIGHT_MCP_PROFILE_DIRECTORY",
 ] as const;
 
 export function log(msg: string) {
@@ -164,10 +132,6 @@ function getClientEnv(): Record<string, string> {
 async function run(url: string, args: string[]) {
   const { key, host, port } = parseUrl(url);
 
-  // Extract --gemini-vision flag (not forwarded to server args)
-  const geminiVision = args.includes("--gemini-vision");
-  const filteredArgs = args.filter((a) => a !== "--gemini-vision");
-
   const identity = await getClientIdentity();
   console.error(
     `[rech] connecting to ${host}:${port} (identity: ${identity.gitUrl || `${identity.hostname}:${identity.cwd}`})`,
@@ -175,7 +139,7 @@ async function run(url: string, args: string[]) {
   const res = await fetch(`http://${host}:${port}/run`, {
     method: "POST",
     headers: { "Content-Type": "application/json", Authorization: `Bearer ${key}` },
-    body: JSON.stringify({ args: filteredArgs, identity, env: getClientEnv(), geminiVision }),
+    body: JSON.stringify({ args, identity, env: getClientEnv() }),
     signal: AbortSignal.timeout(70_000),
   }).catch((e) => {
     console.error(`[rech] ${e.message}`);
@@ -187,12 +151,11 @@ async function run(url: string, args: string[]) {
     process.exit(1);
   }
 
-  const { status, stdout, stderr, files, descriptions, existingSession } = (await res.json()) as {
+  const { status, stdout, stderr, files, existingSession } = (await res.json()) as {
     status: number;
     stdout: string;
     stderr: string;
     files?: string[];
-    descriptions?: Record<string, string>;
     existingSession?: boolean;
   };
 
@@ -217,9 +180,6 @@ async function run(url: string, args: string[]) {
       const dest = join(dlDir, basename(name));
       await Bun.write(dest, fileRes);
       console.error(`[rech] downloaded: ${dest}`);
-      if (descriptions?.[name]) {
-        console.error(`[rech] vision: ${descriptions[name]}`);
-      }
     }
   }
 

package/rech.ts

@@ -35,44 +35,12 @@ if (existsSync(envFile)) {
   });
 }
 
-/** Describe an image using Gemini vision API. Returns description or null on failure. */
-export async function describeImage(imagePath: string): Promise<string | null> {
-  const apiKey = process.env.GEMINI_API_KEY;
-  if (!apiKey) return null;
-  try {
-    const imageData = await file(imagePath).arrayBuffer();
-    const base64 = Buffer.from(imageData).toString("base64");
-    const mimeType = imagePath.endsWith(".png") ? "image/png" : "image/jpeg";
-    const res = await fetch(
-      `https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-pro-preview:generateContent?key=${apiKey}`,
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          contents: [
-            {
-              parts: [
-                {
-                  text: "Describe this browser screenshot concisely in 2-3 sentences. Focus on what's visible: page layout, content, any errors or issues.",
-                },
-                { inline_data: { mime_type: mimeType, data: base64 } },
-              ],
-            },
-          ],
-        }),
-      },
-    );
-    if (!res.ok) return null;
-    const json = await res.json();
-    return json.candidates?.[0]?.content?.parts?.[0]?.text?.trim() ?? null;
-  } catch {
-    return null;
-  }
-}
 
 export const PASSTHROUGH_ENV_KEYS = [
   "PLAYWRIGHT_MCP_EXTENSION_ID",
   "PLAYWRIGHT_MCP_EXTENSION_TOKEN",
+  "PLAYWRIGHT_MCP_USER_DATA_DIR",
+  "PLAYWRIGHT_MCP_PROFILE_DIRECTORY",
 ] as const;
 
 export function log(msg: string) {
@@ -164,10 +132,6 @@ function getClientEnv(): Record<string, string> {
 async function run(url: string, args: string[]) {
   const { key, host, port } = parseUrl(url);
 
-  // Extract --gemini-vision flag (not forwarded to server args)
-  const geminiVision = args.includes("--gemini-vision");
-  const filteredArgs = args.filter((a) => a !== "--gemini-vision");
-
   const identity = await getClientIdentity();
   console.error(
     `[rech] connecting to ${host}:${port} (identity: ${identity.gitUrl || `${identity.hostname}:${identity.cwd}`})`,
@@ -175,7 +139,7 @@ async function run(url: string, args: string[]) {
   const res = await fetch(`http://${host}:${port}/run`, {
     method: "POST",
     headers: { "Content-Type": "application/json", Authorization: `Bearer ${key}` },
-    body: JSON.stringify({ args: filteredArgs, identity, env: getClientEnv(), geminiVision }),
+    body: JSON.stringify({ args, identity, env: getClientEnv() }),
     signal: AbortSignal.timeout(70_000),
   }).catch((e) => {
     console.error(`[rech] ${e.message}`);
@@ -187,12 +151,11 @@ async function run(url: string, args: string[]) {
     process.exit(1);
   }
 
-  const { status, stdout, stderr, files, descriptions, existingSession } = (await res.json()) as {
+  const { status, stdout, stderr, files, existingSession } = (await res.json()) as {
     status: number;
     stdout: string;
     stderr: string;
     files?: string[];
-    descriptions?: Record<string, string>;
     existingSession?: boolean;
   };
 
@@ -217,9 +180,6 @@ async function run(url: string, args: string[]) {
       const dest = join(dlDir, basename(name));
       await Bun.write(dest, fileRes);
       console.error(`[rech] downloaded: ${dest}`);
-      if (descriptions?.[name]) {
-        console.error(`[rech] vision: ${descriptions[name]}`);
-      }
     }
   }
 

package/serve.js

@@ -7,7 +7,6 @@ import {
   parseUrl,
   getOrCreateUrl,
   authCheck,
-  describeImage,
   RECH_DIR,
   PASSTHROUGH_ENV_KEYS,
 } from "./rech.js";
@@ -53,7 +52,6 @@ export async function serve() {
       let sessionId: string;
       let clientName = "";
       let clientEnv: Record<string, string> = {};
-      let geminiVision = false;
       if (Array.isArray(body)) {
         args = body;
         const clientAddr = `${req.headers.get("x-forwarded-for") || server.requestIP(req)?.address || "unknown"}`;
@@ -82,7 +80,6 @@ export async function serve() {
             if (typeof body.env[key] === "string") clientEnv[key] = body.env[key];
           }
         }
-        if (body.geminiVision) geminiVision = true;
       }
 
       let clientSession = "";
@@ -96,7 +93,7 @@ export async function serve() {
       });
       const namespacedSession = clientSession ? `${sessionId}-${clientSession}` : sessionId;
 
-      const bin = process.env.PLAYWRIGHT_CLI || "playwright-cli";
+      const [bin, ...binArgs] = (process.env.PLAYWRIGHT_CLI || "playwright-cli").split(" ");
 
       if (filteredArgs.length === 0) {
         filteredArgs.push("--help");
@@ -108,7 +105,7 @@ export async function serve() {
       const isOpenCmd = filteredArgs[0] === "open";
       if (isOpenCmd) {
         try {
-          const listProc = Bun.spawn([bin, "tab-list", "--extension", `-s=${namespacedSession}`], {
+          const listProc = Bun.spawn([bin, ...binArgs, "tab-list", "--extension", `-s=${namespacedSession}`], {
             cwd: workDir,
             stdin: "ignore",
             stdout: "pipe",
@@ -150,7 +147,7 @@ export async function serve() {
         ...(clientName ? { PLAYWRIGHT_MCP_CLIENT_NAME: clientName } : {}),
         ...passthroughEnv,
       };
-      const proc = Bun.spawn([bin, ...filteredArgs, "--extension", `-s=${namespacedSession}`], {
+      const proc = Bun.spawn([bin, ...binArgs, ...filteredArgs, "--extension", `-s=${namespacedSession}`], {
         cwd: workDir,
         stdin: "ignore",
         stdout: "pipe",
@@ -202,24 +199,12 @@ export async function serve() {
         }
       }
 
-      // Auto-describe screenshot files with Gemini vision (opt-in via --gemini-vision)
-      const descriptions: Record<string, string> = {};
-      if (geminiVision) {
-        for (const f of outputFiles) {
-          if (/\.(?:png|jpe?g)$/i.test(f)) {
-            const desc = await describeImage(join(workDir, f));
-            if (desc) descriptions[f] = desc;
-          }
-        }
-      }
-
       const rebrand = (s: string) => s.replaceAll("npx playwright-cli", "rech");
       return Response.json({
         status,
         stdout: rebrand(stdout),
         stderr: rebrand(stderr),
         files: outputFiles,
-        descriptions,
       });
     },
   });

package/serve.ts

@@ -7,7 +7,6 @@ import {
   parseUrl,
   getOrCreateUrl,
   authCheck,
-  describeImage,
   RECH_DIR,
   PASSTHROUGH_ENV_KEYS,
 } from "./rech.ts";
@@ -53,7 +52,6 @@ export async function serve() {
       let sessionId: string;
       let clientName = "";
       let clientEnv: Record<string, string> = {};
-      let geminiVision = false;
       if (Array.isArray(body)) {
         args = body;
         const clientAddr = `${req.headers.get("x-forwarded-for") || server.requestIP(req)?.address || "unknown"}`;
@@ -82,7 +80,6 @@ export async function serve() {
             if (typeof body.env[key] === "string") clientEnv[key] = body.env[key];
           }
         }
-        if (body.geminiVision) geminiVision = true;
       }
 
       let clientSession = "";
@@ -96,7 +93,7 @@ export async function serve() {
       });
       const namespacedSession = clientSession ? `${sessionId}-${clientSession}` : sessionId;
 
-      const bin = process.env.PLAYWRIGHT_CLI || "playwright-cli";
+      const [bin, ...binArgs] = (process.env.PLAYWRIGHT_CLI || "playwright-cli").split(" ");
 
       if (filteredArgs.length === 0) {
         filteredArgs.push("--help");
@@ -108,7 +105,7 @@ export async function serve() {
       const isOpenCmd = filteredArgs[0] === "open";
       if (isOpenCmd) {
         try {
-          const listProc = Bun.spawn([bin, "tab-list", "--extension", `-s=${namespacedSession}`], {
+          const listProc = Bun.spawn([bin, ...binArgs, "tab-list", "--extension", `-s=${namespacedSession}`], {
             cwd: workDir,
             stdin: "ignore",
             stdout: "pipe",
@@ -150,7 +147,7 @@ export async function serve() {
         ...(clientName ? { PLAYWRIGHT_MCP_CLIENT_NAME: clientName } : {}),
         ...passthroughEnv,
       };
-      const proc = Bun.spawn([bin, ...filteredArgs, "--extension", `-s=${namespacedSession}`], {
+      const proc = Bun.spawn([bin, ...binArgs, ...filteredArgs, "--extension", `-s=${namespacedSession}`], {
         cwd: workDir,
         stdin: "ignore",
         stdout: "pipe",
@@ -202,24 +199,12 @@ export async function serve() {
         }
       }
 
-      // Auto-describe screenshot files with Gemini vision (opt-in via --gemini-vision)
-      const descriptions: Record<string, string> = {};
-      if (geminiVision) {
-        for (const f of outputFiles) {
-          if (/\.(?:png|jpe?g)$/i.test(f)) {
-            const desc = await describeImage(join(workDir, f));
-            if (desc) descriptions[f] = desc;
-          }
-        }
-      }
-
       const rebrand = (s: string) => s.replaceAll("npx playwright-cli", "rech");
       return Response.json({
         status,
         stdout: rebrand(stdout),
         stderr: rebrand(stderr),
         files: outputFiles,
-        descriptions,
       });
     },
   });