@andespindola/brainlink 0.1.0-beta.44 → 0.1.0-beta.45

package/CHANGELOG.md

@@ -44,6 +44,8 @@
 - Added `blink pack-backup` for offline second-stage compression backups of encrypted `.blpk` packs, outside the online query path.
 - Hardened Linux browser launch flags for Ubuntu 26 Chromium/Wayland compatibility (`--disable-vulkan`, `--use-gl=swiftshader`, `--ozone-platform-hint=x11`).
 - Improved pack resilience by auto-repairing missing search-pack manifests from existing `.blpk` files, avoiding unnecessary full repacks on small incremental updates.
+- Updated Linux graph auto-open behavior to prioritize the system default browser (`xdg-open`) before explicit browser fallbacks.
+- Removed implicit Chromium dependency in Linux auto-open flow; app-window launch is now opt-in (`BRAINLINK_LINUX_APP_WINDOW=1`).
 
 ## 0.1.0-beta.3
 

package/README.md

@@ -572,6 +572,7 @@ By default, `blink server` tries to open the graph in a native desktop GUI windo
 On Linux, native GUI is disabled by default for better startup performance. Enable it with `BRAINLINK_LINUX_NATIVE_GUI=1`.
 If native GUI launch is unavailable on your system, it falls back to dedicated app-window mode and then to the default browser.
 For Chromium-family browsers on Linux (`chromium`, `chromium-browser`, `google-chrome`, `microsoft-edge`, `brave-browser`), Brainlink now auto-applies compatibility flags during launch (`--ozone-platform=x11`, `--ozone-platform-hint=x11`, `--disable-gpu`, `--disable-vulkan`, `--use-gl=swiftshader`, `--disable-features=Vulkan,VaapiVideoDecoder`, `--disable-background-networking`) to avoid common Wayland/Vulkan/VAAPI startup issues.
+On Linux, Brainlink opens the graph through the system default browser first (`xdg-open`), then `$BROWSER`/detected browsers as fallback. Chromium-family app-window mode is optional via `BRAINLINK_LINUX_APP_WINDOW=1`.
 Use `--no-open` to keep it headless.
 When native GUI is used, the GUI window automatically closes when the `blink server` process stops.
 

package/dist/cli/commands/write-commands.js

@@ -333,6 +333,73 @@ const commandExists = (command) => {
         return false;
     }
 };
+const readLinuxDefaultBrowserDesktopEntry = () => {
+    try {
+        const preferred = spawnSync('xdg-settings', ['get', 'default-web-browser'], { encoding: 'utf8' });
+        const rawPreferred = preferred.status === 0 ? preferred.stdout.trim() : '';
+        if (rawPreferred.length > 0) {
+            return rawPreferred;
+        }
+    }
+    catch {
+        // fallback below
+    }
+    try {
+        const fallback = spawnSync('xdg-mime', ['query', 'default', 'x-scheme-handler/https'], { encoding: 'utf8' });
+        const rawFallback = fallback.status === 0 ? fallback.stdout.trim() : '';
+        return rawFallback.length > 0 ? rawFallback : null;
+    }
+    catch {
+        return null;
+    }
+};
+const toLinuxDefaultBrowserCommands = (desktopEntry) => {
+    if (!desktopEntry) {
+        return [];
+    }
+    const normalized = desktopEntry.toLowerCase().trim();
+    if (normalized.includes('firefox')) {
+        return ['firefox'];
+    }
+    if (normalized.includes('edge')) {
+        return ['microsoft-edge', 'microsoft-edge-stable'];
+    }
+    if (normalized.includes('brave')) {
+        return ['brave-browser'];
+    }
+    if (normalized.includes('chromium')) {
+        return ['chromium', 'chromium-browser'];
+    }
+    if (normalized.includes('chrome')) {
+        return ['google-chrome', 'google-chrome-stable'];
+    }
+    return [];
+};
+const readBrowserEnvCommands = () => {
+    const value = process.env.BROWSER?.trim();
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(':')
+        .map((entry) => entry.trim().split(/\s+/)[0] ?? '')
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+};
+const prioritizeLinuxBrowserCandidates = (candidates) => {
+    const preferredCommands = toLinuxDefaultBrowserCommands(readLinuxDefaultBrowserDesktopEntry());
+    if (preferredCommands.length === 0) {
+        return candidates;
+    }
+    const priorityMap = new Map(preferredCommands.map((command, index) => [command, index]));
+    return [...candidates].sort((left, right) => {
+        const leftPriority = priorityMap.get(left[0]);
+        const rightPriority = priorityMap.get(right[0]);
+        const leftScore = leftPriority == null ? Number.POSITIVE_INFINITY : leftPriority;
+        const rightScore = rightPriority == null ? Number.POSITIVE_INFINITY : rightPriority;
+        return leftScore - rightScore;
+    });
+};
 const envFlagEnabled = (name) => process.env[name] === '1' || process.env[name] === 'true';
 const spawnAnyDetached = (candidates) => candidates.some(([command, args]) => spawnDetached(command, args));
 const spawnAnyDetachedWithEnv = (candidates) => candidates.some(([command, args, env]) => spawnDetached(command, args, env));
@@ -435,6 +502,10 @@ const openGraphInAppWindow = (url) => {
         ]);
     }
     const appArgument = `--app=${url}`;
+    const linuxAppWindowEnabled = envFlagEnabled('BRAINLINK_LINUX_APP_WINDOW');
+    if (!linuxAppWindowEnabled) {
+        return false;
+    }
     const linuxChromiumStableFlags = [
         '--ozone-platform=x11',
         '--ozone-platform-hint=x11',
@@ -486,17 +557,25 @@ const openGraphInDetectedBrowser = (url) => {
         GDK_BACKEND: 'x11',
         OZONE_PLATFORM: 'x11'
     };
+    const envBrowserCandidates = readBrowserEnvCommands()
+        .map((command) => command.includes('firefox')
+        ? [command, ['-new-window', url], undefined]
+        : [command, [url], undefined])
+        .filter(([command]) => commandExists(command));
+    if (envBrowserCandidates.length > 0 && spawnAnyDetachedWithEnv(envBrowserCandidates)) {
+        return true;
+    }
     const linuxBrowserCandidates = [
+        ['firefox', ['-new-window', url], undefined],
         ['microsoft-edge', [...linuxChromiumStableFlags, url], linuxChromiumEnv],
         ['microsoft-edge-stable', [...linuxChromiumStableFlags, url], linuxChromiumEnv],
         ['google-chrome', [...linuxChromiumStableFlags, url], linuxChromiumEnv],
         ['google-chrome-stable', [...linuxChromiumStableFlags, url], linuxChromiumEnv],
-        ['chromium', [...linuxChromiumStableFlags, url], linuxChromiumEnv],
-        ['chromium-browser', [...linuxChromiumStableFlags, url], linuxChromiumEnv],
         ['brave-browser', [...linuxChromiumStableFlags, url], linuxChromiumEnv],
-        ['firefox', ['-new-window', url], undefined]
+        ['chromium', [...linuxChromiumStableFlags, url], linuxChromiumEnv],
+        ['chromium-browser', [...linuxChromiumStableFlags, url], linuxChromiumEnv]
     ];
-    const available = linuxBrowserCandidates.filter(([command]) => commandExists(command));
+    const available = prioritizeLinuxBrowserCandidates(linuxBrowserCandidates.filter(([command]) => commandExists(command)));
     return spawnAnyDetachedWithEnv(available);
 };
 const openUrlInUi = (url, parentPid) => {
@@ -512,6 +591,18 @@ const openUrlInUi = (url, parentPid) => {
     if (nativeGuiEnabled && openGraphInNativeGui(url, parentPid)) {
         return { opened: true, mode: 'native-gui' };
     }
+    if (platform() === 'linux') {
+        if (spawnDetached('xdg-open', [url])) {
+            return { opened: true, mode: 'browser' };
+        }
+        if (openGraphInDetectedBrowser(url)) {
+            return { opened: true, mode: 'browser' };
+        }
+        if (openGraphInAppWindow(url)) {
+            return { opened: true, mode: 'app-window' };
+        }
+        return { opened: false, mode: 'none' };
+    }
     if (openGraphInAppWindow(url)) {
         return { opened: true, mode: 'app-window' };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andespindola/brainlink",
-  "version": "0.1.0-beta.44",
+  "version": "0.1.0-beta.45",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",