brave-real-browser-mcp-server 2.9.13 → 2.9.14

package/README.md

@@ -114,8 +114,8 @@ assistants to control a real browser, extract content, and more.
 
 - **🔄 Auto-Update System**: Automatically updates all dependencies to latest versions on every `npm install`
 - **Stealth by default**: All browser instances use anti-detection features
-- **Enhanced Windows support**: Comprehensive Chrome detection and ECONNREFUSED error fixes (v1.3.0)
-- **Smart Chrome detection**: Registry-based detection + 15+ installation paths (Windows)
+- **Enhanced Windows support**: Comprehensive Brave detection and ECONNREFUSED error fixes
+- **Smart Brave detection**: Registry-based detection + 13+ installation paths (Windows)
 - **Connection resilience**: Automatic localhost/127.0.0.1 fallback with port management
 - **Multiple retry strategies**: 5 different connection approaches with progressive fallback
 - **Advanced configuration**: Full support for all brave-real-browser options
@@ -133,25 +133,24 @@ assistants to control a real browser, extract content, and more.
 
 - Node.js >= 18.0.0
 - npm or yarn
-- Google Chrome or Chromium browser installed
+- Brave Browser 13+ installed
 - Basic understanding of TypeScript/JavaScript (for development)
 
 ### Platform-Specific Requirements
 
 **Windows:**
-- Google Chrome installation (automatic detection in v1.3.0+ includes):
-  - Standard installations: `C:\Program Files\Google\Chrome\Application\chrome.exe`
-  - 32-bit installations: `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe`
-  - User installations: `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`
-  - Chrome Canary: `%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe`
+- Brave Browser installation (automatic detection includes):
+  - Standard installations: `C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe`
+  - 32-bit installations: `C:\Program Files (x86)\BraveSoftware\Brave-Browser\Application\brave.exe`
+  - User installations: `%LOCALAPPDATA%\BraveSoftware\Brave-Browser\Application\brave.exe`
   - Portable installations and Registry-detected paths
-  - Manual path specification: Use `CHROME_PATH` environment variable
+  - Manual path specification: Use `BRAVE_PATH` environment variable
 
 **macOS:**
-- Google Chrome or Chromium must be installed in `/Applications/`
+- Brave Browser must be installed in `/Applications/Brave Browser.app`
 
 **Linux:**
-- Install Chrome/Chromium: `sudo apt-get install -y google-chrome-stable` or `sudo apt-get install -y chromium-browser`
+- Install Brave: `sudo apt install brave-browser` or via snap: `sudo snap install brave`
 - Install xvfb for headless operation: `sudo apt-get install -y xvfb`
 
 ## Installation for Developers
@@ -231,11 +230,11 @@ This command:
 
 #### Method 2: Add with Environment Variables
 
-If you need to configure proxy settings or custom Chrome paths:
+If you need to configure proxy settings or custom Brave paths:
 
 ```bash
 claude mcp add brave-real-browser \
-  -e CHROME_PATH="/path/to/chrome" \
+  -e BRAVE_PATH="/path/to/brave" \
   -e PROXY_URL="http://proxy:8080" \
   -- npx brave-real-browser-mcp-server@latest
 ```
@@ -262,7 +261,7 @@ claude mcp add-json brave-real-browser '{
   "command": "npx",
   "args": ["brave-real-browser-mcp-server@latest"],
   "env": {
-    "CHROME_PATH": "/path/to/chrome",
+    "BRAVE_PATH": "/path/to/brave",
     "PROXY_URL": "http://proxy:8080"
   }
 }'
@@ -299,7 +298,7 @@ After adding the server:
 
 - **Automatic Updates**: Using `@latest` ensures you get bug fixes and improvements
 - **No Installation**: npx handles downloading and running automatically  
-- **Environment Variables**: Easy configuration of proxies, Chrome paths, etc.
+- **Environment Variables**: Easy configuration of proxies, Brave paths, etc.
 - **Scope Control**: Choose where the server is available (local/project/user)
 - **Team Sharing**: Project scope allows sharing configurations with teammates
 - **Status Monitoring**: Built-in `/mcp` command for server health checks
@@ -337,7 +336,7 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
 
 > **Important:** Just like Claude Desktop, Cursor will use `npx` to automatically download and run the server. You don't need to install anything with npm!
 
-**Windows-Specific Configuration (if experiencing Chrome path issues):**
+**Windows-Specific Configuration (if experiencing Brave path issues):**
 ```json
 {
   "mcpServers": {
@@ -345,7 +344,7 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
       "command": "npx",
       "args": ["brave-real-browser-mcp-server@latest"],
       "env": {
-        "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
+        "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
       }
     }
   }
@@ -354,7 +353,7 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
 
 > **Note**: Browser options like headless mode should be configured when initializing the browser through the `browser_init` tool, not via environment variables.
 
-**Advanced Configuration with Custom Chrome Path:**
+**Advanced Configuration with Custom Brave Path:**
 ```json
 {
   "mcpServers": {
@@ -362,7 +361,7 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
       "command": "npx",
       "args": ["brave-real-browser-mcp-server@latest"],
       "env": {
-        "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
+        "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
       }
     }
   }
@@ -371,34 +370,34 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
 
 > **Note**: Proxy settings and browser options should be configured when asking Claude to initialize the browser using the `browser_init` tool.
 
-#### Platform-Specific Chrome Paths for Cursor IDE
+#### Platform-Specific Brave Paths for Cursor IDE
 
-If Chrome auto-detection fails, you can specify the Chrome path using the `CHROME_PATH` environment variable:
+If Brave auto-detection fails, you can specify the Brave path using the `BRAVE_PATH` environment variable:
 
 **Windows:**
 ```json
 "env": {
-  "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
+  "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
 }
 ```
 Alternative Windows paths:
-- `"C:/Program Files (x86)/Google/Chrome/Application/chrome.exe"`
-- `"%LOCALAPPDATA%/Google/Chrome/Application/chrome.exe"`
+- `"C:/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe"`
+- `"%LOCALAPPDATA%/BraveSoftware/Brave-Browser/Application/brave.exe"`
 
 **macOS:**
 ```json
 "env": {
-  "CHROME_PATH": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+  "BRAVE_PATH": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
 }
 ```
 
 **Linux:**
 ```json
 "env": {
-  "CHROME_PATH": "/usr/bin/google-chrome"
+  "BRAVE_PATH": "/usr/bin/brave-browser"
 }
 ```
-Alternative Linux paths: `/usr/bin/chromium-browser`, `/snap/bin/chromium`
+Alternative Linux paths: `/usr/bin/brave`, `/snap/bin/brave`
 
 
 #### Testing Cursor IDE Setup
@@ -423,9 +422,9 @@ If successful, you should see:
    - Ensure Node.js 18+ is installed
 
 2. **"Browser failed to launch" on Windows**
-   - Add explicit Chrome path in `executablePath`
+   - Add explicit Brave path in `executablePath`
    - Try running Cursor IDE as Administrator
-   - Check Windows Defender isn't blocking Chrome
+   - Check Windows Defender isn't blocking Brave
 
 3. **"Permission denied"**
    - Use `sudo npm install -g brave-real-browser-mcp-server` on Linux/Mac
@@ -548,7 +547,7 @@ AI: I'll set up the browser with your proxy configuration.
 The server includes intelligent element discovery capabilities through the `find_selector` tool:
 
 - **Text-based element finding**: Automatically locates elements containing specific text
-- **Smart CSS selector generation**: Creates unique, robust CSS selectors similar to Chrome DevTools
+- **Smart CSS selector generation**: Creates unique, robust CSS selectors similar to browser DevTools
 - **Element type filtering**: Optionally restrict search to specific HTML elements (e.g., buttons, links)
 - **Exact or partial text matching**: Choose between precise text matching or substring searches
 - **Universal compatibility**: Works across any website without hardcoded selectors
@@ -586,27 +585,27 @@ brave-real-browser implementation.
 
 ## Configuration
 
-### Automatic Chrome Path Detection (Enhanced in v1.3.0)
+### Automatic Brave Path Detection
 
-The server automatically detects Chrome installation paths across different operating systems with significantly improved Windows support:
+The server automatically detects Brave Browser installation paths across different operating systems:
 
-- **Windows (v1.3.0+)**: 
-  - Registry-based detection for installed Chrome versions
-  - Searches 15+ common installation directories including Program Files, user-specific locations, and portable installations
-  - Support for Chrome Canary fallback
-  - Environment variable detection (`CHROME_PATH`, `PUPPETEER_EXECUTABLE_PATH`)
-  - Detailed troubleshooting guidance when Chrome is not found
+- **Windows**: 
+  - Registry-based detection for installed Brave versions
+  - Searches 13+ common installation directories including Program Files, user-specific locations, and portable installations
+  - Support for Brave Nightly fallback
+  - Environment variable detection (`BRAVE_PATH`)
+  - Detailed troubleshooting guidance when Brave is not found
   
-- **macOS**: Looks for Chrome in `/Applications/Google Chrome.app/` and Chrome Canary locations
+- **macOS**: Looks for Brave in `/Applications/Brave Browser.app/` and Brave Nightly locations
 
-- **Linux**: Checks multiple locations including `/usr/bin/google-chrome`, `/usr/bin/chromium-browser`, and snap installations
+- **Linux**: Checks multiple locations including `/usr/bin/brave-browser`, `/usr/bin/brave`, and snap installations
 
-**Windows Registry Detection** (NEW in v1.3.0):
-The server now queries Windows Registry to find Chrome installations, making detection more reliable across different installation types.
+**Windows Registry Detection**:
+The server queries Windows Registry to find Brave installations, making detection more reliable across different installation types.
 
-If Chrome is not found automatically, you can specify a custom path using:
-1. Environment variable: `set CHROME_PATH="C:\Your\Chrome\Path\chrome.exe"`
-2. Browser init option: `customConfig.chromePath` when initializing the browser
+If Brave is not found automatically, you can specify a custom path using:
+1. Environment variable: `set BRAVE_PATH="C:\Your\Brave\Path\brave.exe"`
+2. Browser init option: `customConfig.bravePath` when initializing the browser
 
 ### Configuring Custom Options (like headless mode)
 Custom options like headless mode are **not configured in the MCP config file**. Instead, they're passed when initializing the browser using the `browser_init` tool:
@@ -633,7 +632,7 @@ When initializing with `browser_init`, you can configure:
 
 - `headless`: true/false (Set to true for headless operation)
 - `disableXvfb`: true/false (Disable X Virtual Framebuffer)
-- `ignoreAllFlags`: true/false (Ignore all Chrome flags)
+- `ignoreAllFlags`: true/false (Ignore all browser flags)
 - `proxy`: "https://proxy:8080" (Proxy server URL)
 - `plugins`: ["plugin1", "plugin2"] (Array of plugins to load)
 - `connectOption`: Additional connection options like:
@@ -662,11 +661,11 @@ When initializing the browser with `browser_init`, you can configure:
 
 ### Advanced Configuration Examples
 
-#### Specifying Custom Chrome Path
+#### Specifying Custom Brave Path
 ```json
 {
   "customConfig": {
-    "chromePath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
+    "bravePath": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
   }
 }
 ```
@@ -709,14 +708,14 @@ For advanced users, you can modify the server behavior by editing the source cod
 
 Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0.1:60725` error commonly experienced on Windows systems:
 
-**Enhanced Chrome Path Detection:**
-- Added Windows Registry-based Chrome detection
-- Expanded search to 15+ Windows installation locations including portable installations
-- Added support for Chrome Canary fallback
-- Environment variable support (`CHROME_PATH`, `PUPPETEER_EXECUTABLE_PATH`)
+**Enhanced Brave Path Detection:**
+- Added Windows Registry-based Brave detection
+- Expanded search to 13+ Windows installation locations including portable installations
+- Added support for Brave Nightly fallback
+- Environment variable support (`BRAVE_PATH`)
 
 **Windows-Specific Launch Optimizations:**
-- 20+ Windows-specific Chrome flags for better compatibility
+- 20+ Windows-specific browser flags for better compatibility
 - Multiple fallback strategies (5 different connection approaches)
 - Progressive retry logic with exponential backoff
 - Enhanced timeout handling (120s for Windows vs 90s for other platforms)
@@ -731,12 +730,12 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
 
 1. **Environment Variables (Recommended):**
    ```bash
-   set CHROME_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"
+   set BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
    ```
 
-2. **Manual Chrome Path Configuration:**
+2. **Manual Brave Path Configuration:**
    ```text
-   Ask Claude: "Initialize browser with custom Chrome path at C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
+   Ask Claude: "Initialize browser with custom Brave path at C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
    ```
 
 3. **Network Troubleshooting:**
@@ -750,10 +749,10 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
    # Ensure: 127.0.0.1 localhost
    ```
 
-4. **Chrome Process Management:**
+4. **Brave Process Management:**
    ```bash
-   # Kill existing Chrome processes
-   taskkill /f /im chrome.exe
+   # Kill existing Brave processes
+   taskkill /f /im brave.exe
    ```
 
 ### Common Issues
@@ -812,20 +811,20 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
    - Check your PATH includes npm global binaries: `npm config get prefix`
 
 3. **Browser won't start**
-   - Check if Chrome/Chromium is installed in standard locations
+   - Check if Brave Browser is installed in standard locations
    - **Windows specific troubleshooting**:
      
-     **Step 1: Verify Chrome Installation Paths**
+     **Step 1: Verify Brave Installation Paths**
      Check these locations in order:
-     - `C:\Program Files\Google\Chrome\Application\chrome.exe`
-     - `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe`
-     - `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`
-     - `%PROGRAMFILES%\Google\Chrome\Application\chrome.exe`
+     - `C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe`
+     - `C:\Program Files (x86)\BraveSoftware\Brave-Browser\Application\brave.exe`
+     - `%LOCALAPPDATA%\BraveSoftware\Brave-Browser\Application\brave.exe`
+     - `%PROGRAMFILES%\BraveSoftware\Brave-Browser\Application\brave.exe`
      
      **Step 2: Manual Path Configuration**
-     If Chrome is in a different location, specify it manually:
+     If Brave is in a different location, specify it manually:
      ```
-     Ask Claude: "Initialize browser with custom Chrome path at C:\Your\Chrome\Path\chrome.exe"
+     Ask Claude: "Initialize browser with custom Brave path at C:\Your\Brave\Path\brave.exe"
      ```
      
      **Step 3: Windows Launch Arguments**
@@ -836,15 +835,15 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
      
      **Step 4: Windows-Specific Solutions**
      - **Run as Administrator**: Try running your IDE/terminal as Administrator
-     - **Windows Defender**: Add Chrome and Node.js to Windows Defender exclusions
-     - **Antivirus Software**: Temporarily disable antivirus to test if it's blocking Chrome
+     - **Windows Defender**: Add Brave and Node.js to Windows Defender exclusions
+     - **Antivirus Software**: Temporarily disable antivirus to test if it's blocking Brave
      - **User Account Control**: Lower UAC settings temporarily for testing
-     - **Chrome Processes**: Kill any existing Chrome processes in Task Manager
+     - **Brave Processes**: Kill any existing Brave processes in Task Manager
      
-     **Step 5: Alternative Chrome Installation**
-     If Chrome detection still fails:
-     - Download Chrome directly from [google.com/chrome](https://www.google.com/chrome/)
-     - Install to default location (`C:\Program Files\Google\Chrome\`)
+     **Step 5: Alternative Brave Installation**
+     If Brave detection still fails:
+     - Download Brave directly from [brave.com/download](https://brave.com/download/)
+     - Install to default location (`C:\Program Files\BraveSoftware\Brave-Browser\`)
      - Restart your IDE after installation
      
      **Step 6: PowerShell vs Command Prompt**
@@ -857,10 +856,10 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
      - Clear npm cache: `npm cache clean --force`
      - Reinstall global packages: `npm install -g brave-real-browser-mcp-server@latest`
      
-   - **Linux**: Install dependencies: `sudo apt-get install -y google-chrome-stable`
-   - **macOS**: Ensure Chrome is in `/Applications/`
+   - **Linux**: Install Brave: `sudo apt install brave-browser`
+   - **macOS**: Ensure Brave is in `/Applications/Brave Browser.app`
    - Try with `headless: true` first
-   - Check console output for Chrome path detection messages
+   - Check console output for Brave path detection messages
 
 4. **Claude doesn't see the MCP server**
    - Verify `claude_desktop_config.json` is in the correct location
@@ -886,7 +885,7 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
      - Check if server status shows "connected" or error messages
    
    - **Environment Variables**:
-     - If using custom environment variables (Chrome path, proxy), verify they're correctly set
+     - If using custom environment variables (Brave path, proxy), verify they're correctly set
      - Test without environment variables first: `claude mcp add brave-real-browser -- npx brave-real-browser-mcp-server@latest`
    
    - **Node.js and npx Issues**:
@@ -917,7 +916,7 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
    - **JSON Syntax Validation**:
      - Use [jsonlint.com](https://jsonlint.com/) to validate JSON syntax
      - Common issues: missing commas, incorrect quotes, trailing commas
-     - Ensure proper escaping of Windows paths: `"C:/Program Files/Google/Chrome/Application/chrome.exe"`
+     - Ensure proper escaping of Windows paths: `"C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"`
    
    - **Cursor IDE Restart Process**:
      - Close Cursor IDE completely (check Task Manager on Windows)
@@ -1009,11 +1008,11 @@ A: Supports reCAPTCHA, hCaptcha, and Cloudflare Turnstile through brave-real-bro
 **Q: Is this detectable by websites?**
 A: brave-real-browser includes anti-detection features, but no solution is 100% undetectable.
 
-**Q: Can I use custom Chrome extensions?**
+**Q: Can I use custom browser extensions?**
 A: Yes, through the `plugins` option in browser_init.
 
 **Q: Does it work on all operating systems?**
-A: Yes, tested on Windows, macOS, and Linux. The server automatically detects Chrome installations on all platforms.
+A: Yes, tested on Windows, macOS, and Linux. The server automatically detects Brave installations on all platforms.
 
 **Q: What's the difference between Claude Desktop, Claude Code CLI, and Cursor IDE configurations?**
 A: Here's a comparison:
@@ -1034,30 +1033,30 @@ A: Here's a comparison:
 - **Claude Code CLI**: `claude mcp add brave-real-browser -- npx brave-real-browser-mcp-server@latest`
 - **Cursor IDE**: One-click install or manual JSON config
 
-**Q: What if Chrome is installed in a non-standard location?**
-A: Version 1.3.0 dramatically improves Chrome detection. The server now searches 15+ locations including portable installations and uses Windows Registry detection. If Chrome is still not found automatically, you can:
-1. Set environment variable: `set CHROME_PATH="C:\Your\Chrome\Path\chrome.exe"`
-2. Use the `customConfig.chromePath` option: `{"customConfig": {"chromePath": "C:\\Custom\\Chrome\\chrome.exe"}}`
-
-**Q: Why am I getting "Chrome not found" or ECONNREFUSED errors on Windows?**
-A: Version 1.3.0 includes comprehensive fixes for Windows Chrome detection and connection issues. The server now automatically searches these locations and more:
-- `C:\Program Files\Google\Chrome\Application\chrome.exe`
-- `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe` 
-- `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`
-- `%USERPROFILE%\AppData\Local\Google\Chrome\Application\chrome.exe`
-- Chrome Canary installations
-- Portable Chrome installations
+**Q: What if Brave is installed in a non-standard location?**
+A: The server dramatically improves Brave detection by searching 13+ locations including portable installations and using Windows Registry detection. If Brave is still not found automatically, you can:
+1. Set environment variable: `set BRAVE_PATH="C:\Your\Brave\Path\brave.exe"`
+2. Use the `customConfig.bravePath` option: `{"customConfig": {"bravePath": "C:\\Custom\\Brave\\brave.exe"}}`
+
+**Q: Why am I getting "Brave not found" or ECONNREFUSED errors on Windows?**
+A: The server includes comprehensive fixes for Windows Brave detection and connection issues. The server now automatically searches these locations and more:
+- `C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe`
+- `C:\Program Files (x86)\BraveSoftware\Brave-Browser\Application\brave.exe` 
+- `%LOCALAPPDATA%\BraveSoftware\Brave-Browser\Application\brave.exe`
+- `%USERPROFILE%\AppData\Local\BraveSoftware\Brave-Browser\Application\brave.exe`
+- Brave Nightly installations
+- Portable Brave installations
 - Registry-detected installations
 
-The server also implements multiple connection strategies with automatic fallback between localhost and 127.0.0.1, plus enhanced Windows-specific Chrome flags for better compatibility.
+The server also implements multiple connection strategies with automatic fallback between localhost and 127.0.0.1, plus enhanced Windows-specific browser flags for better compatibility.
 
-**Q: I'm still getting ECONNREFUSED errors after upgrading to v1.3.0. What should I do?**
+**Q: I'm still getting ECONNREFUSED errors. What should I do?**
 A: Try these steps in order:
-1. Set the `CHROME_PATH` environment variable to your Chrome location
-2. Kill all existing Chrome processes: `taskkill /f /im chrome.exe`
+1. Set the `BRAVE_PATH` environment variable to your Brave location
+2. Kill all existing Brave processes: `taskkill /f /im brave.exe`
 3. Check your Windows hosts file contains: `127.0.0.1 localhost`
 4. Try running your IDE as Administrator
-5. Add Chrome to Windows Defender exclusions
+5. Add Brave to Windows Defender exclusions
 6. If using a VPN/proxy, try disabling it temporarily
 
 ### Debug Mode
@@ -1156,7 +1155,7 @@ npm run test:debug    # Environment diagnostics and troubleshooting
 
 Debug tools provide:
 - Environment validation (Node.js version, platform, memory)
-- Chrome installation detection with specific paths
+- Brave installation detection with specific paths
 - Quick server health check with startup timing
 - Network connectivity validation
 - Build status verification

package/dist/browser-manager.js

@@ -165,28 +165,28 @@ export function isCircuitBreakerOpen() {
     }
     return false;
 }
-// Windows Registry Chrome detection
-function getWindowsChromeFromRegistry() {
+// Windows Registry Brave detection
+function getWindowsBraveFromRegistry() {
     if (process.platform !== 'win32')
         return null;
     try {
         const { execSync } = require('child_process');
         const registryQueries = [
-            'reg query "HKEY_CURRENT_USER\\Software\\Google\\Chrome\\BLBeacon" /v version 2>nul',
-            'reg query "HKEY_LOCAL_MACHINE\\Software\\Google\\Chrome\\BLBeacon" /v version 2>nul',
-            'reg query "HKEY_LOCAL_MACHINE\\Software\\WOW6432Node\\Google\\Chrome\\BLBeacon" /v version 2>nul',
+            'reg query "HKEY_CURRENT_USER\\Software\\BraveSoftware\\Brave-Browser\\BLBeacon" /v version 2>nul',
+            'reg query "HKEY_LOCAL_MACHINE\\Software\\BraveSoftware\\Brave-Browser\\BLBeacon" /v version 2>nul',
+            'reg query "HKEY_LOCAL_MACHINE\\Software\\WOW6432Node\\BraveSoftware\\Brave-Browser\\BLBeacon" /v version 2>nul',
         ];
         for (const query of registryQueries) {
             try {
                 const result = execSync(query, { encoding: 'utf8', timeout: 5000 });
                 if (result) {
                     const standardPaths = [
-                        'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
-                        'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe'
+                        'C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe',
+                        'C:\\Program Files (x86)\\BraveSoftware\\Brave-Browser\\Application\\brave.exe'
                     ];
                     for (const standardPath of standardPaths) {
                         if (fs.existsSync(standardPath)) {
-                            console.error(`✓ Found Chrome via Registry detection: ${standardPath}`);
+                            console.error(`✓ Found Brave via Registry detection: ${standardPath}`);
                             return standardPath;
                         }
                     }
@@ -197,11 +197,11 @@ function getWindowsChromeFromRegistry() {
             }
         }
         try {
-            const installDirQuery = 'reg query "HKEY_LOCAL_MACHINE\\Software\\Microsoft\\Windows\\CurrentVersion\\App Paths\\chrome.exe" /ve 2>nul';
+            const installDirQuery = 'reg query "HKEY_LOCAL_MACHINE\\Software\\Microsoft\\Windows\\CurrentVersion\\App Paths\\brave.exe" /ve 2>nul';
             const result = execSync(installDirQuery, { encoding: 'utf8', timeout: 5000 });
             const match = result.match(/REG_SZ\s+(.+\.exe)/);
             if (match && match[1] && fs.existsSync(match[1])) {
-                console.error(`✓ Found Chrome via App Paths registry: ${match[1]}`);
+                console.error(`✓ Found Brave via App Paths registry: ${match[1]}`);
                 return match[1];
             }
         }
@@ -210,39 +210,35 @@ function getWindowsChromeFromRegistry() {
         }
     }
     catch (error) {
-        console.error('Windows Registry Chrome detection failed:', error instanceof Error ? error.message : String(error));
+        console.error('Windows Registry Brave detection failed:', error instanceof Error ? error.message : String(error));
     }
     return null;
 }
-// Chrome path detection for cross-platform support with enhanced Windows support
-export function detectChromePath() {
+// Brave path detection for cross-platform support with enhanced Windows support
+export function detectBravePath() {
     const platform = process.platform;
     // Check environment variables first
-    const envChromePath = process.env.CHROME_PATH || process.env.PUPPETEER_EXECUTABLE_PATH;
-    if (envChromePath && fs.existsSync(envChromePath)) {
-        console.error(`✓ Found Chrome via environment variable: ${envChromePath}`);
-        return envChromePath;
+    const envBravePath = process.env.BRAVE_PATH || process.env.PUPPETEER_EXECUTABLE_PATH;
+    if (envBravePath && fs.existsSync(envBravePath)) {
+        console.error(`✓ Found Brave via environment variable: ${envBravePath}`);
+        return envBravePath;
     }
     let possiblePaths = [];
     switch (platform) {
         case 'win32':
             possiblePaths = [
-                'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
-                'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
-                path.join(process.env.LOCALAPPDATA || '', 'Google\\Chrome\\Application\\chrome.exe'),
-                path.join(process.env.USERPROFILE || '', 'AppData\\Local\\Google\\Chrome\\Application\\chrome.exe'),
-                path.join(process.env.PROGRAMFILES || '', 'Google\\Chrome\\Application\\chrome.exe'),
-                path.join(process.env['PROGRAMFILES(X86)'] || '', 'Google\\Chrome\\Application\\chrome.exe'),
-                path.join(process.env.LOCALAPPDATA || '', 'Google\\Chrome SxS\\Application\\chrome.exe'),
-                'C:\\Program Files\\Google\\Chrome SxS\\Application\\chrome.exe',
-                'C:\\Users\\Public\\Desktop\\Google Chrome.exe',
-                path.join(process.env.APPDATA || '', 'Google\\Chrome\\Application\\chrome.exe'),
-                'C:\\Chrome\\chrome.exe',
-                'C:\\google\\chrome\\chrome.exe',
-                'C:\\PortableApps\\GoogleChromePortable\\App\\Chrome-bin\\chrome.exe',
+                'C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe',
+                'C:\\Program Files (x86)\\BraveSoftware\\Brave-Browser\\Application\\brave.exe',
+                path.join(process.env.LOCALAPPDATA || '', 'BraveSoftware\\Brave-Browser\\Application\\brave.exe'),
+                path.join(process.env.USERPROFILE || '', 'AppData\\Local\\BraveSoftware\\Brave-Browser\\Application\\brave.exe'),
+                path.join(process.env.PROGRAMFILES || '', 'BraveSoftware\\Brave-Browser\\Application\\brave.exe'),
+                path.join(process.env['PROGRAMFILES(X86)'] || '', 'BraveSoftware\\Brave-Browser\\Application\\brave.exe'),
+                'C:\\Users\\Public\\Desktop\\Brave Browser.lnk',
+                'C:\\Brave\\brave.exe',
+                'C:\\portable\\Brave\\brave.exe',
             ];
             try {
-                const registryPath = getWindowsChromeFromRegistry();
+                const registryPath = getWindowsBraveFromRegistry();
                 if (registryPath) {
                     possiblePaths.unshift(registryPath);
                 }
@@ -253,31 +249,28 @@ export function detectChromePath() {
             break;
         case 'darwin':
             possiblePaths = [
-                '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-                '/Applications/Chromium.app/Contents/MacOS/Chromium',
-                '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary'
+                '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
+                '/Applications/Brave Browser Nightly.app/Contents/MacOS/Brave Browser Nightly',
             ];
             break;
         case 'linux':
             possiblePaths = [
-                '/usr/bin/google-chrome',
-                '/usr/bin/google-chrome-stable',
-                '/usr/bin/chromium-browser',
-                '/usr/bin/chromium',
-                '/snap/bin/chromium',
-                '/usr/bin/chrome',
-                '/opt/google/chrome/chrome'
+                '/usr/bin/brave-browser',
+                '/usr/bin/brave',
+                '/snap/bin/brave',
+                '/var/lib/snapd/snap/bin/brave',
+                '/opt/brave.com/brave/brave',
             ];
             break;
         default:
-            console.error(`Platform ${platform} not explicitly supported for Chrome path detection`);
+            console.error(`Platform ${platform} not explicitly supported for Brave path detection`);
             return null;
     }
-    for (const chromePath of possiblePaths) {
+    for (const bravePath of possiblePaths) {
         try {
-            if (fs.existsSync(chromePath)) {
-                console.error(`✓ Found Chrome at: ${chromePath}`);
-                return chromePath;
+            if (fs.existsSync(bravePath)) {
+                console.error(`✓ Found Brave at: ${bravePath}`);
+                return bravePath;
             }
         }
         catch (error) {
@@ -285,7 +278,7 @@ export function detectChromePath() {
         }
     }
     if (platform === 'win32') {
-        console.error(`❌ Chrome not found at any expected Windows paths:`);
+        console.error(`❌ Brave not found at any expected Windows paths:`);
         console.error(`   Searched ${possiblePaths.length} locations:`);
         possiblePaths.slice(0, 8).forEach(path => console.error(`   - ${path}`));
         if (possiblePaths.length > 8) {
@@ -293,23 +286,23 @@ export function detectChromePath() {
         }
         console.error(`\n   🔧 Windows Troubleshooting Solutions:`);
         console.error(`   1. Environment Variables (Recommended):`);
-        console.error(`      - Set CHROME_PATH environment variable to your Chrome location`);
-        console.error(`      - Example: set CHROME_PATH="C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"`);
+        console.error(`      - Set BRAVE_PATH environment variable to your Brave location`);
+        console.error(`      - Example: set BRAVE_PATH=\"C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe\"`);
         console.error(`      - For Cursor IDE: Add env vars to MCP configuration`);
-        console.error(`\n   2. Chrome Installation:`);
-        console.error(`      - Download/reinstall Chrome: https://www.google.com/chrome/`);
-        console.error(`      - Check if Chrome is installed for all users vs current user only`);
-        console.error(`      - Try Chrome Canary if regular Chrome fails`);
+        console.error(`\n   2. Brave Installation:`);
+        console.error(`      - Download/reinstall Brave: https://brave.com/download/`);
+        console.error(`      - Check if Brave is installed for all users vs current user only`);
+        console.error(`      - Try Brave Nightly if regular Brave fails`);
         console.error(`\n   3. Permissions & Security:`);
         console.error(`      - Run IDE/terminal as Administrator`);
-        console.error(`      - Add Chrome to Windows Defender exclusions`);
-        console.error(`      - Check if antivirus software is blocking Chrome`);
+        console.error(`      - Add Brave to Windows Defender exclusions`);
+        console.error(`      - Check if antivirus software is blocking Brave`);
         console.error(`\n   4. Custom Configuration:`);
-        console.error(`      - Use customConfig.chromePath parameter in browser_init`);
-        console.error(`      - Example: {"customConfig": {"chromePath": "C:\\\\custom\\\\path\\\\chrome.exe"}}`);
+        console.error(`      - Use customConfig.bravePath parameter in browser_init`);
+        console.error(`      - Example: {\"customConfig\": {\"bravePath\": \"C:\\\\\\custom\\\\\\path\\\\\\brave.exe\"}}`);
     }
     else {
-        console.error(`❌ Chrome not found at any expected paths for platform: ${platform}`);
+        console.error(`❌ Brave not found at any expected paths for platform: ${platform}`);
         console.error(`   Searched locations:`);
         possiblePaths.forEach(path => console.error(`   - ${path}`));
     }
@@ -396,10 +389,10 @@ export async function initializeBrowser(options) {
                 await closeBrowser();
             }
         }
-        const detectedChromePath = detectChromePath();
+        const detectedBravePath = detectBravePath();
         const customConfig = options?.customConfig ?? {};
         const platform = process.platform;
-        const getOptimalChromeFlags = (isWindows, isRetry = false) => {
+        const getOptimalBrowserFlags = (isWindows, isRetry = false) => {
             // 2025 best practices: Minimal, secure, performance-focused flags
             const baseFlags = [
                 '--no-first-run',
@@ -426,16 +419,16 @@ export async function initializeBrowser(options) {
         // When ignoreAllFlags=true, brave-real-browser skips DEFAULT_FLAGS modification
         // which causes the analytics popup issue
         const useIgnoreAllFlags = options?.ignoreAllFlags ?? false;
-        // Don't pass chromeFlags in customConfig - let brave-real-browser handle it via ignoreAllFlags=false
-        const chromeConfig = {
+        // Don't pass braveFlags in customConfig - let brave-real-browser handle it via ignoreAllFlags=false
+        const browserConfig = {
             ...customConfig
         };
-        if (detectedChromePath && !chromeConfig.chromePath) {
-            chromeConfig.chromePath = detectedChromePath;
+        if (detectedBravePath && !browserConfig.bravePath) {
+            browserConfig.bravePath = detectedBravePath;
         }
         const connectOptions = {
             headless: options?.headless ?? false,
-            customConfig: chromeConfig,
+            customConfig: browserConfig,
             turnstile: true,
             disableXvfb: options?.disableXvfb ?? true,
             // CRITICAL: Must be false by default to allow brave-real-browser to modify flags
@@ -448,7 +441,8 @@ export async function initializeBrowser(options) {
             },
         };
         if (options?.proxy) {
-            connectOptions.customConfig.chromeFlags.push(`--proxy-server=${options.proxy}`);
+            connectOptions.customConfig.braveFlags = connectOptions.customConfig.braveFlags || [];
+            connectOptions.customConfig.braveFlags.push(`--proxy-server=${options.proxy}`);
         }
         if (options?.plugins && Array.isArray(options.plugins)) {
             connectOptions.plugins = options.plugins;
@@ -470,10 +464,10 @@ export async function initializeBrowser(options) {
                 ...connectOptions,
                 ...modifications,
                 customConfig: {
-                    ...chromeConfig,
+                    ...browserConfig,
                     ...modifications.customConfig,
-                    chromeFlags: [
-                        ...(modifications.customConfig?.chromeFlags || chromeConfig.chromeFlags),
+                    braveFlags: [
+                        ...(modifications.customConfig?.braveFlags || browserConfig.braveFlags || []),
                         ...(availablePort ? [`--remote-debugging-port=${availablePort}`] : ['--remote-debugging-port=0'])
                     ]
                 }
@@ -484,7 +478,7 @@ export async function initializeBrowser(options) {
         const primaryStrategy = {
             strategyName: 'User-Defined Configuration',
             strategy: {
-                executablePath: detectedChromePath,
+                executablePath: detectedBravePath,
                 headless: options?.headless ?? false,
                 turnstile: true,
                 args: [
@@ -493,7 +487,7 @@ export async function initializeBrowser(options) {
                 disableXvfb: true,
                 // CRITICAL: Must be false to allow brave-real-browser to process DEFAULT_FLAGS
                 ignoreAllFlags: false,
-                customConfig: chromeConfig,
+                customConfig: browserConfig,
                 connectOption: {
                     defaultViewport: null,
                 },
@@ -505,7 +499,7 @@ export async function initializeBrowser(options) {
             createConnectionStrategy('Minimal Configuration', {
                 customConfig: {
                     ignoreDefaultFlags: false,
-                    chromeFlags: [
+                    braveFlags: [
                         '--no-first-run',
                         '--no-default-browser-check',
                         '--disable-default-apps',
@@ -517,7 +511,7 @@ export async function initializeBrowser(options) {
             createConnectionStrategy('Optimal Configuration', {
                 customConfig: {
                     ignoreDefaultFlags: false,
-                    chromeFlags: [
+                    braveFlags: [
                         '--no-first-run',
                         '--no-default-browser-check',
                         '--disable-default-apps',
@@ -529,7 +523,7 @@ export async function initializeBrowser(options) {
             createConnectionStrategy('Network Fallback', {
                 customConfig: {
                     ignoreDefaultFlags: false,
-                    chromeFlags: [
+                    braveFlags: [
                         '--no-first-run',
                         '--no-default-browser-check',
                         '--disable-default-apps',
@@ -552,8 +546,8 @@ export async function initializeBrowser(options) {
                         console.error(`   Strategy config: ${JSON.stringify({
                             headless: strategy.headless,
                             ignoreAllFlags: strategy.ignoreAllFlags,
-                            chromeFlags: strategy.customConfig?.chromeFlags || 'none',
-                            chromePath: strategy.customConfig?.chromePath || 'default'
+                            braveFlags: strategy.customConfig?.braveFlags || 'none',
+                            bravePath: strategy.customConfig?.bravePath || 'default'
                         })}`);
                         const connectResult = await connect(strategy);
                         console.error(`   ✅ Connection successful with ${strategyName}`);
@@ -569,8 +563,8 @@ export async function initializeBrowser(options) {
                                 ...strategy,
                                 customConfig: {
                                     ...strategy.customConfig,
-                                    chromeFlags: [
-                                        ...strategy.customConfig.chromeFlags.filter((flag) => !flag.includes('remote-debugging-address')),
+                                    braveFlags: [
+                                        ...(strategy.customConfig.braveFlags || []).filter((flag) => !flag.includes('remote-debugging-address')),
                                         `--remote-debugging-address=${fallbackHost}`
                                     ]
                                 }
@@ -592,13 +586,13 @@ export async function initializeBrowser(options) {
                 lastError = error instanceof Error ? error : new Error(String(error));
                 console.error(`❌ ${strategyName} failed:`, lastError.message);
                 if (lastError.message.includes('ECONNREFUSED')) {
-                    console.error(`   🔍 ECONNREFUSED detected - likely Chrome connection/port issue`);
+                    console.error(`   🔍 ECONNREFUSED detected - likely Brave connection/port issue`);
                 }
                 else if (lastError.message.includes('ENOENT') || lastError.message.includes('spawn')) {
-                    console.error(`   🔍 Chrome executable issue detected`);
+                    console.error(`   🔍 Brave executable issue detected`);
                 }
                 else if (lastError.message.includes('timeout')) {
-                    console.error(`   🔍 Connection timeout - Chrome may be slow to start`);
+                    console.error(`   🔍 Connection timeout - Brave may be slow to start`);
                 }
                 if (strategyIndex < connectionStrategies.length - 1) {
                     const delayMs = 2000 + (strategyIndex * 1000);
@@ -609,7 +603,7 @@ export async function initializeBrowser(options) {
         }
         updateCircuitBreakerOnFailure();
         const errorMessage = lastError ? lastError.message : 'Unknown connection error';
-        if (errorMessage.includes('ENOENT') || errorMessage.includes('spawn') || errorMessage.includes('chrome') || errorMessage.includes('ECONNREFUSED')) {
+        if (errorMessage.includes('ENOENT') || errorMessage.includes('spawn') || errorMessage.includes('ECONNREFUSED')) {
             if (platform === 'win32') {
                 console.error(`❌ All browser connection strategies failed on Windows:`);
                 console.error(`   Final Error: ${errorMessage}`);
@@ -617,34 +611,33 @@ export async function initializeBrowser(options) {
                 if (errorMessage.includes('ECONNREFUSED')) {
                     console.error(`\n   🚨 ECONNREFUSED Error Specific Solutions:`);
                     console.error(`   1. Port/Connection Issues:`);
-                    console.error(`      - Chrome DevTools Protocol port is being blocked`);
-                    console.error(`      - Add Chrome to Windows Firewall exceptions`);
+                    console.error(`      - Browser DevTools Protocol port is being blocked`);
+                    console.error(`      - Add Brave to Windows Firewall exceptions`);
                     console.error(`      - Check if localhost resolves to 127.0.0.1 (run: ping localhost)`);
-                    console.error(`      - Try different Chrome flags: --remote-debugging-port=0`);
+                    console.error(`      - Try different browser flags: --remote-debugging-port=0`);
                     console.error(`\n   2. Network Configuration:`);
                     console.error(`      - Disable VPN/proxy temporarily`);
                     console.error(`      - Check Windows hosts file (C:\\Windows\\System32\\drivers\\etc\\hosts)`);
                     console.error(`      - Ensure localhost points to 127.0.0.1`);
-                    console.error(`\n   3. Chrome Process Management:`);
-                    console.error(`      - Kill all chrome.exe processes in Task Manager`);
-                    console.error(`      - Clear Chrome user data: %LOCALAPPDATA%\\Google\\Chrome\\User Data`);
-                    console.error(`      - Try running Chrome manually to test: chrome.exe --remote-debugging-port=9222`);
+                    console.error(`\n   3. Browser Process Management:`);
+                    console.error(`      - Kill all brave.exe processes in Task Manager`);
+                    console.error(`      - Clear Brave user data: %LOCALAPPDATA%\\BraveSoftware\\Brave-Browser\\User Data`);
+                    console.error(`      - Try running Brave manually to test: brave.exe --remote-debugging-port=9222`);
                 }
                 console.error(`\n   🔧 General Solutions:`);
                 console.error(`   1. Environment Variables (Recommended):`);
-                console.error(`      - Set CHROME_PATH environment variable`);
-                console.error(`      - Example: set CHROME_PATH="C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"`);
-                console.error(`\n   2. Chrome Installation:`);
-                console.error(`      - Download/reinstall Chrome: https://www.google.com/chrome/`);
-                console.error(`      - Try Chrome Canary: https://www.google.com/chrome/canary/`);
+                console.error(`      - Set BRAVE_PATH environment variable`);
+                console.error(`      - Example: set BRAVE_PATH="C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"`);
+                console.error(`\n   2. Brave Installation:`);
+                console.error(`      - Download/reinstall Brave: https://brave.com/download/`);
+                console.error(`      - Try Brave Nightly: https://brave.com/download-nightly/`);
                 console.error(`\n   3. Permissions & Security:`);
                 console.error(`      - Run as Administrator`);
-                console.error(`      - Add Chrome to Windows Defender exclusions`);
+                console.error(`      - Add Brave to Windows Defender exclusions`);
                 console.error(`      - Temporarily disable antivirus software`);
                 console.error(`\n   4. Advanced Configuration:`);
-                console.error(`      - Use customConfig.chromePath in browser_init`);
+                console.error(`      - Use customConfig.bravePath in browser_init`);
                 console.error(`      - Try headless mode: {"headless": true}`);
-                console.error(`      - Use environment variable: PUPPETEER_EXECUTABLE_PATH`);
             }
             else {
                 console.error(`❌ Browser launch failed on ${platform}:`);
@@ -702,21 +695,23 @@ export async function closeBrowser() {
         }
     }
 }
-// Force kill all Chrome processes system-wide
-export async function forceKillAllChromeProcesses() {
+// Force kill all Brave processes system-wide
+export async function forceKillAllBrowserProcesses() {
     try {
         const { spawn } = await import('child_process');
         if (process.platform !== 'win32') {
-            spawn('pkill', ['-f', 'Google Chrome'], { stdio: 'ignore' });
-            spawn('pkill', ['-f', 'chrome'], { stdio: 'ignore' });
+            // Brave processes
+            spawn('pkill', ['-f', 'Brave Browser'], { stdio: 'ignore' });
+            spawn('pkill', ['-f', 'brave'], { stdio: 'ignore' });
         }
         else {
-            spawn('taskkill', ['/F', '/IM', 'chrome.exe'], { stdio: 'ignore' });
-            spawn('taskkill', ['/F', '/IM', 'GoogleChrome.exe'], { stdio: 'ignore' });
+            // Brave on Windows
+            spawn('taskkill', ['/F', '/IM', 'brave.exe'], { stdio: 'ignore' });
+            spawn('taskkill', ['/F', '/IM', 'Brave.exe'], { stdio: 'ignore' });
         }
     }
     catch (error) {
-        console.error('Error force-killing Chrome processes:', error);
+        console.error('Error force-killing browser processes:', error);
     }
 }
 // Getters for browser instances

package/dist/browser-manager.test.js

@@ -5,12 +5,12 @@
  * - AAA Pattern (Arrange-Act-Assert)
  * - Behavior-focused testing with proper mocking
  * - Error categorization and circuit breaker testing
- * - Chrome detection and network utilities testing
+ * - Brave detection and network utilities testing
  */
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 import * as fs from 'fs';
 import * as net from 'net';
-import { BrowserErrorType, categorizeError, withTimeout, isPortAvailable, testHostConnectivity, findAvailablePort, updateCircuitBreakerOnFailure, updateCircuitBreakerOnSuccess, isCircuitBreakerOpen, detectChromePath, validateSession, findAuthElements, getBrowserInstance, getPageInstance, getContentPriorityConfig, updateContentPriorityConfig, forceKillAllChromeProcesses } from './browser-manager.js';
+import { BrowserErrorType, categorizeError, withTimeout, isPortAvailable, testHostConnectivity, findAvailablePort, updateCircuitBreakerOnFailure, updateCircuitBreakerOnSuccess, isCircuitBreakerOpen, detectBravePath, validateSession, findAuthElements, getBrowserInstance, getPageInstance, getContentPriorityConfig, updateContentPriorityConfig, forceKillAllBrowserProcesses } from './browser-manager.js';
 // Mock external dependencies
 vi.mock('fs');
 vi.mock('net');
@@ -256,58 +256,58 @@ describe('Browser Manager', () => {
             Date.now = originalNow;
         });
     });
-    describe('Chrome Path Detection', () => {
+    describe('Brave Path Detection', () => {
         it('should return environment variable path when available', () => {
             // Arrange: Set environment variable and mock file exists
-            const chromePath = '/custom/chrome/path';
-            process.env.CHROME_PATH = chromePath;
+            const bravePath = '/custom/brave/path';
+            process.env.BRAVE_PATH = bravePath;
             vi.mocked(fs.existsSync).mockReturnValue(true);
-            // Act: Detect Chrome path
-            const result = detectChromePath();
+            // Act: Detect Brave path
+            const result = detectBravePath();
             // Assert: Should return environment path
-            expect(result).toBe(chromePath);
-            expect(fs.existsSync).toHaveBeenCalledWith(chromePath);
+            expect(result).toBe(bravePath);
+            expect(fs.existsSync).toHaveBeenCalledWith(bravePath);
             // Cleanup
-            delete process.env.CHROME_PATH;
+            delete process.env.BRAVE_PATH;
         });
-        it('should return null when Chrome is not found', () => {
+        it('should return null when Brave is not found', () => {
             // Arrange: Mock file system to return false for all paths
             vi.mocked(fs.existsSync).mockReturnValue(false);
-            delete process.env.CHROME_PATH;
+            delete process.env.BRAVE_PATH;
             delete process.env.PUPPETEER_EXECUTABLE_PATH;
-            // Act: Detect Chrome path
-            const result = detectChromePath();
+            // Act: Detect Brave path
+            const result = detectBravePath();
             // Assert: Should return null
             expect(result).toBe(null);
         });
-        it('should detect Chrome on macOS platform', () => {
+        it('should detect Brave on macOS platform', () => {
             // Arrange: Mock platform and file system
             Object.defineProperty(process, 'platform', { value: 'darwin' });
-            const expectedPath = '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome';
+            const expectedPath = '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser';
             vi.mocked(fs.existsSync).mockImplementation((path) => path === expectedPath);
-            delete process.env.CHROME_PATH;
-            // Act: Detect Chrome path
-            const result = detectChromePath();
-            // Assert: Should return macOS Chrome path
+            delete process.env.BRAVE_PATH;
+            // Act: Detect Brave path
+            const result = detectBravePath();
+            // Assert: Should return macOS Brave path
             expect(result).toBe(expectedPath);
         });
-        it('should detect Chrome on Linux platform', () => {
+        it('should detect Brave on Linux platform', () => {
             // Arrange: Mock platform and file system
             Object.defineProperty(process, 'platform', { value: 'linux' });
-            const expectedPath = '/usr/bin/google-chrome';
+            const expectedPath = '/usr/bin/brave-browser';
             vi.mocked(fs.existsSync).mockImplementation((path) => path === expectedPath);
-            delete process.env.CHROME_PATH;
-            // Act: Detect Chrome path
-            const result = detectChromePath();
-            // Assert: Should return Linux Chrome path
+            delete process.env.BRAVE_PATH;
+            // Act: Detect Brave path
+            const result = detectBravePath();
+            // Assert: Should return Linux Brave path
             expect(result).toBe(expectedPath);
         });
         it('should return null for unsupported platform', () => {
             // Arrange: Mock unsupported platform
             Object.defineProperty(process, 'platform', { value: 'freebsd' });
-            delete process.env.CHROME_PATH;
-            // Act: Detect Chrome path
-            const result = detectChromePath();
+            delete process.env.BRAVE_PATH;
+            // Act: Detect Brave path
+            const result = detectBravePath();
             // Assert: Should return null
             expect(result).toBe(null);
         });
@@ -377,17 +377,17 @@ describe('Browser Manager', () => {
             expect(page).toBe(null);
         });
     });
-    describe('Force Kill Chrome Processes', () => {
+    describe('Force Kill Browser Processes', () => {
         it('should execute without throwing errors', async () => {
-            // Arrange & Act: Force kill Chrome processes
+            // Arrange & Act: Force kill browser processes
             // Act & Assert: Should not throw error regardless of platform
-            await expect(forceKillAllChromeProcesses()).resolves.toBeUndefined();
+            await expect(forceKillAllBrowserProcesses()).resolves.toBeUndefined();
         });
         it('should handle different platforms', async () => {
             // Arrange: Test with current platform
             const originalPlatform = process.platform;
             // Act: Execute force kill
-            await forceKillAllChromeProcesses();
+            await forceKillAllBrowserProcesses();
             // Assert: Should complete without error
             expect(process.platform).toBe(originalPlatform);
         });

package/dist/index.js

@@ -13,7 +13,7 @@ import { TOOLS, SERVER_INFO, CAPABILITIES, TOOL_NAMES } from './tool-definitions
 console.error('🔍 [DEBUG] Loading system utils...');
 import { withErrorHandling } from './system-utils.js';
 console.error('🔍 [DEBUG] Loading browser manager...');
-import { closeBrowser, forceKillAllChromeProcesses } from './browser-manager.js';
+import { closeBrowser, forceKillAllBrowserProcesses } from './browser-manager.js';
 console.error('🔍 [DEBUG] Loading core infrastructure...');
 import { setupProcessCleanup } from './core-infrastructure.js';
 // Import handlers
@@ -266,7 +266,7 @@ async function main() {
     setupProcessCleanup(async () => {
         console.error('🔍 [DEBUG] Process cleanup triggered');
         await closeBrowser();
-        await forceKillAllChromeProcesses();
+        await forceKillAllBrowserProcesses();
     });
     // Create and start the server transport
     console.error('🔍 [DEBUG] Creating StdioServerTransport...');

package/dist/tool-definitions.js

@@ -25,7 +25,7 @@ export const DEFAULT_CONTENT_PRIORITY_CONFIG = {
 export const TOOLS = [
     {
         name: 'browser_init',
-        description: 'Initialize a new browser instance with anti-detection features and automatic Chrome path detection',
+        description: 'Initialize a new browser instance with anti-detection features and automatic Brave Browser path detection',
         inputSchema: {
             type: 'object',
             properties: {
@@ -41,7 +41,7 @@ export const TOOLS = [
                 },
                 ignoreAllFlags: {
                     type: 'boolean',
-                    description: 'Ignore all Chrome flags (recommended: true for clean startup without --no-sandbox)',
+                    description: 'Ignore all browser flags (recommended: true for clean startup without --no-sandbox)',
                     default: true,
                 },
                 proxy: {
@@ -62,11 +62,11 @@ export const TOOLS = [
                 },
                 customConfig: {
                     type: 'object',
-                    description: 'Custom configuration for Chrome launcher. Use chromePath to specify custom Chrome executable path',
+                    description: 'Custom configuration for Brave launcher. Use bravePath to specify custom Brave executable path',
                     properties: {
-                        chromePath: {
+                        bravePath: {
                             type: 'string',
-                            description: 'Custom path to Chrome executable (auto-detected if not specified)',
+                            description: 'Custom path to Brave executable (auto-detected if not specified)',
                         },
                     },
                     additionalProperties: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "2.9.13",
+  "version": "2.9.14",
   "description": "MCP server for brave-real-browser",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     "test:integration": "vitest run test/integration",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",
     "test:e2e:watch": "vitest --config vitest.e2e.config.ts",
-    "test:chrome:cleanup": "pkill -f 'Google Chrome' || true"
+    "test:brave:cleanup": "pkill -f 'Brave Browser' || true"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.0",