@browserbridge/bbx 1.5.0 → 1.5.1

package/README.md

@@ -107,7 +107,7 @@ Browser Bridge is optimized for the opposite starting point: **inspect the state
 
 1. Install [Browser Bridge from the Chrome Web Store](https://chromewebstore.google.com/detail/browser-bridge/jjjkmmcdkpcgamlopogicbnnhdgebhie) in Chrome or another Chromium-based browser
 2. `npm install -g @browserbridge/bbx` - installs the CLI and native host
-3. Run `bbx install`, or target a specific browser with `bbx install --browser edge`, `bbx install --browser brave`, `bbx install --browser chromium`, or `bbx install --browser arc`
+3. Run `bbx install` (Chromium on Linux, Chrome elsewhere), or target a specific browser with `bbx install --browser chrome`, `bbx install --browser edge`, `bbx install --browser brave`, `bbx install --browser chromium`, or `bbx install --browser arc`
 4. In the extension side panel, install MCP or CLI (skill) for your agent of choice
 5. Enable Browser Bridge for the browser window you want to inspect/control with the AI agent
 6. Ask your agent to use Browser Bridge via MCP (`BB MCP` or `Browser Bridge MCP`), or invoke the installed Browser Bridge skill in CLI mode (`/browser-bridge`, `browser-bridge`, or the client-specific skill trigger)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserbridge/bbx",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "private": false,
   "keywords": [
     "agent-tools",

package/packages/agent-client/src/command-registry.js

@@ -237,7 +237,7 @@ export const CLI_HELP_SECTIONS = Object.freeze([
   {
     title: 'Setup',
     lines: [
-      'bbx install [extension-id] [--browser chrome|edge|brave|chromium|arc] [--all]  Install native messaging manifest',
+      'bbx install [extension-id] [--browser chrome|edge|brave|chromium|arc] [--all]  Install native messaging manifest (Linux defaults to Chromium)',
       'bbx uninstall                                                      Remove native host manifests, Browser Bridge runtime files, and managed MCP/skill installs',
       'bbx install-skill [targets|all] [--global] [--project <path>]      Install/update the managed Browser Bridge CLI skill',
       'bbx install-mcp [client|all] [--local]                             Write MCP config for codex|claude|cursor|copilot|opencode|antigravity|windsurf|agents',

package/packages/agent-client/src/runtime.js

@@ -113,7 +113,7 @@ export async function withBridgeClient(callback) {
 }
 
 /**
- * @param {SupportedBrowser} [browser='chrome']
+ * @param {SupportedBrowser} [browser]
  * @returns {string}
  */
 export function getManifestPath(browser) {
@@ -121,7 +121,7 @@ export function getManifestPath(browser) {
 }
 
 /**
- * @param {SupportedBrowser} [browser='chrome']
+ * @param {SupportedBrowser} [browser]
  * @returns {Promise<{allowed_origins?: string[]} | null>}
  */
 export async function loadInstalledManifest(browser) {

package/packages/native-host/bin/install-manifest.js

@@ -9,7 +9,7 @@ import {
   parseExtensionId,
   uninstallNativeManifest,
 } from '../src/install-manifest.js';
-import { SUPPORTED_BROWSERS } from '../src/config.js';
+import { getDefaultBrowser, SUPPORTED_BROWSERS } from '../src/config.js';
 
 /** @typedef {import('../src/config.js').SupportedBrowser} SupportedBrowser */
 
@@ -61,7 +61,7 @@ const targets = installAll
   ? [...SUPPORTED_BROWSERS]
   : browsers.length > 0
     ? browsers
-    : [/** @type {SupportedBrowser} */ ('chrome')];
+    : [getDefaultBrowser()];
 
 for (const [index, target] of targets.entries()) {
   if (uninstall) {

package/packages/native-host/src/config.js

@@ -1,5 +1,6 @@
 // @ts-check
 
+import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 
@@ -189,14 +190,37 @@ export function getLauncherFilename() {
  */
 export const SUPPORTED_BROWSERS = ['chrome', 'edge', 'brave', 'chromium', 'arc'];
 
+/**
+ * @returns {SupportedBrowser}
+ */
+export function getDefaultBrowser() {
+  return os.platform() === 'linux' ? 'chromium' : 'chrome';
+}
+
+/**
+ * @param {NodeJS.ProcessEnv} env
+ * @param {string} home
+ * @returns {string}
+ */
+function getLinuxConfigHome(env, home) {
+  if (env.CHROME_CONFIG_HOME) {
+    return env.CHROME_CONFIG_HOME;
+  }
+  if (env.XDG_CONFIG_HOME) {
+    return env.XDG_CONFIG_HOME;
+  }
+  return path.join(home, '.config');
+}
+
 /**
  * Return the native messaging host manifest install directory for the given
  * browser on the current platform.
  *
- * @param {SupportedBrowser} [browser='chrome']
+ * @param {SupportedBrowser} [browser=getDefaultBrowser()]
+ * @param {NodeJS.ProcessEnv} [env=process.env]
  * @returns {string}
  */
-export function getManifestInstallDir(browser = 'chrome') {
+export function getManifestInstallDir(browser = getDefaultBrowser(), env = process.env) {
   const platform = os.platform();
   const home = os.homedir();
 
@@ -213,7 +237,7 @@ export function getManifestInstallDir(browser = 'chrome') {
   }
 
   if (platform === 'win32') {
-    const winBase = process.env.LOCALAPPDATA || path.join(home, 'AppData', 'Local');
+    const winBase = env.LOCALAPPDATA || path.join(home, 'AppData', 'Local');
     const winPaths = {
       chrome: path.join(winBase, 'Google', 'Chrome', 'User Data', 'NativeMessagingHosts'),
       edge: path.join(winBase, 'Microsoft', 'Edge', 'User Data', 'NativeMessagingHosts'),
@@ -231,12 +255,18 @@ export function getManifestInstallDir(browser = 'chrome') {
   }
 
   // Linux / others
+  const linuxConfigHome = getLinuxConfigHome(env, home);
+  const chromiumSnapProfile = path.join(home, 'snap', 'chromium', 'common', 'chromium');
+  const useChromiumSnapProfile =
+    !env.CHROME_CONFIG_HOME && !env.XDG_CONFIG_HOME && fs.existsSync(chromiumSnapProfile);
   const linuxPaths = {
-    chrome: path.join(home, '.config', 'google-chrome', 'NativeMessagingHosts'),
-    edge: path.join(home, '.config', 'microsoft-edge', 'NativeMessagingHosts'),
-    brave: path.join(home, '.config', 'BraveSoftware', 'Brave-Browser', 'NativeMessagingHosts'),
-    chromium: path.join(home, '.config', 'chromium', 'NativeMessagingHosts'),
-    arc: path.join(home, '.config', 'Arc', 'User Data', 'NativeMessagingHosts'),
+    chrome: path.join(linuxConfigHome, 'google-chrome', 'NativeMessagingHosts'),
+    edge: path.join(linuxConfigHome, 'microsoft-edge', 'NativeMessagingHosts'),
+    brave: path.join(linuxConfigHome, 'BraveSoftware', 'Brave-Browser', 'NativeMessagingHosts'),
+    chromium: useChromiumSnapProfile
+      ? path.join(chromiumSnapProfile, 'NativeMessagingHosts')
+      : path.join(linuxConfigHome, 'chromium', 'NativeMessagingHosts'),
+    arc: path.join(linuxConfigHome, 'Arc', 'User Data', 'NativeMessagingHosts'),
   };
   return linuxPaths[browser] ?? linuxPaths.chrome;
 }

package/packages/native-host/src/install-manifest.js

@@ -259,13 +259,13 @@ export async function installNativeManifest(options) {
     extensionIdArg,
     browser,
     nodePath = process.execPath,
-    installDir = getManifestInstallDir(browser),
-    bridgeDir = getBridgeDir(),
+    env = process.env,
+    installDir = getManifestInstallDir(browser, env),
+    bridgeDir = getBridgeDir(env),
     stdout = process.stdout,
     stderr = process.stderr,
     preserveCustomExtensionId = false,
     writeRegistryValue: writeRegistryValueFn = writeRegistryValue,
-    env = process.env,
   } = options;
 
   const parsedExtensionId = parseExtensionId(extensionIdArg);