rechrome 1.2.0 → 1.3.0

package/.env.example

@@ -1,9 +1,6 @@
 # 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:
 # PLAYWRIGHT_CLI=playwright-cli-multi-tab

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,7 +78,6 @@ 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)                                                      | —                |

package/package.json

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

package/rech.js

@@ -35,40 +35,6 @@ 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",
@@ -164,10 +130,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 +137,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 +149,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 +178,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,40 +35,6 @@ 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",
@@ -164,10 +130,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 +137,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 +149,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 +178,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 = "";
@@ -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 = "";
@@ -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,
       });
     },
   });