chrome-ai-bridge 1.0.17 → 1.0.18

package/build/src/browser.js

@@ -3,6 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { execSync } from 'node:child_process';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
@@ -421,7 +422,7 @@ export function getDevelopmentExtensionPaths() {
     return developmentExtensionPaths;
 }
 export async function launch(options) {
-    const { channel, executablePath, customDevTools, headless, isolated, loadExtension, loadExtensionsDir, loadSystemExtensions, chromeProfile, } = options;
+    const { channel, executablePath, customDevTools, headless, isolated, loadExtension, loadExtensionsDir, loadSystemExtensions, chromeProfile, focus = false, } = options;
     // Reset development extension paths
     developmentExtensionPaths = [];
     // Resolve user data directory using new profile resolver (v0.15.0+)
@@ -562,6 +563,22 @@ export async function launch(options) {
     }
     let browser;
     let finalUserDataDir = userDataDir;
+    // Remember current foreground app before Chrome launch (for background mode)
+    let previousApp = null;
+    if (!focus && !effectiveHeadless && os.platform() === 'darwin') {
+        try {
+            previousApp = execSync(`osascript -e 'tell application "System Events" to get name of first application process whose frontmost is true'`, { encoding: 'utf-8', timeout: 5000 }).trim();
+            console.error(`📋 Current foreground app: ${previousApp}`);
+        }
+        catch (error) {
+            console.warn(`⚠️  Could not detect foreground app: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Windows/Linux: Add --start-minimized for background mode
+    if (!focus && !effectiveHeadless && os.platform() !== 'darwin') {
+        args.push('--start-minimized');
+        console.error('📋 Added --start-minimized for background mode');
+    }
     try {
         browser = await puppeteer.launch({
             ...connectOptions,
@@ -660,6 +677,18 @@ export async function launch(options) {
             });
             console.error('Applied navigator.webdriver bypass to existing page');
         }
+        // Restore focus to previous app (background mode on macOS)
+        if (!focus && !effectiveHeadless && previousApp && os.platform() === 'darwin') {
+            try {
+                // Small delay to ensure Chrome window is fully rendered
+                await new Promise(resolve => setTimeout(resolve, 500));
+                execSync(`osascript -e 'tell application "${previousApp}" to activate'`, { timeout: 5000 });
+                console.error(`✅ Restored focus to: ${previousApp}`);
+            }
+            catch (error) {
+                console.warn(`⚠️  Could not restore focus: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
         return browser;
     }
     catch (error) {

package/build/src/cli.js

@@ -79,6 +79,11 @@ export const cliOptions = {
         description: 'Explicitly specify the project root directory for profile isolation. Overrides MCP roots/list. Useful when roots/list is not available.',
         conflicts: 'browserUrl',
     },
+    focus: {
+        type: 'boolean',
+        description: 'Bring Chrome window to foreground on launch. By default, Chrome launches in the background to avoid interrupting your work.',
+        default: false,
+    },
 };
 export function parseArguments(version, argv = process.argv) {
     const yargsInstance = yargs(hideBin(argv))

package/build/src/main.js

@@ -140,6 +140,7 @@ async function getContext() {
         userDataDir: args.userDataDir,
         logFile,
         rootsInfo: cachedRootsInfo, // Pass roots info to browser
+        focus: args.focus, // v1.0.18: Background mode control
     };
     const browser = await resolveBrowser(browserOptions);
     // Announce browser PID for graceful shutdown

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-ai-bridge",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "MCP server bridging Chrome browser and AI assistants (ChatGPT, Gemini). Browser automation + AI consultation.",
   "type": "module",
   "bin": "./scripts/cli.mjs",