@andespindola/brainlink 0.1.0-beta.32 → 0.1.0-beta.33

package/README.md

@@ -553,7 +553,8 @@ blink server --host 127.0.0.1 --port 4321 --watch
 ```
 
 By default, the server uses `$HOME/.brainlink/vault`. Pass `--vault ./vault` only when you want to inspect a custom vault.
-By default, `blink server` also opens the graph URL in your default browser. Use `--no-open` to keep it headless.
+By default, `blink server` tries to open the graph in a dedicated app window (`--app=<url>` on compatible browsers).  
+If app-window launch is unavailable, it falls back to the default browser. Use `--no-open` to keep it headless.
 
 The graph UI shows:
 
@@ -843,7 +844,8 @@ blink server --vault ./vault --watch --no-open
 ```
 
 Starts the local read-only graph UI and HTTP API.
-By default, it opens the graph URL in your default browser. Use `--no-open` to skip that behavior.
+By default, it tries to open a dedicated app window for the graph URL and falls back to browser open when app-window mode is unavailable.
+Use `--no-open` to skip that behavior.
 
 The HTTP server only binds to loopback hosts such as `127.0.0.1`, `localhost` or `::1`.
 

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

@@ -1,5 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { mkdir, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
 import { dirname, relative, resolve } from 'node:path';
 import { platform } from 'node:os';
 import { spawn } from 'node:child_process';
@@ -26,28 +27,67 @@ const resolveAddContent = (options) => {
     }
     return readFileSync(options.contentFile, 'utf8');
 };
+const spawnDetached = (command, args) => {
+    try {
+        const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const openGraphInAppWindow = (url) => {
+    if (platform() === 'darwin') {
+        const macCandidates = [
+            '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+            '/Applications/Chromium.app/Contents/MacOS/Chromium',
+            '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge'
+        ]
+            .filter((candidate) => existsSync(candidate))
+            .map((binary) => ({ binary, args: [`--app=${url}`, '--new-window'] }));
+        for (const candidate of macCandidates) {
+            if (spawnDetached(candidate.binary, candidate.args)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    if (platform() === 'win32') {
+        const appArgument = `--app=${url}`;
+        return (spawnDetached('cmd', ['/c', 'start', '', 'chrome', appArgument, '--new-window']) ||
+            spawnDetached('cmd', ['/c', 'start', '', 'msedge', appArgument, '--new-window']) ||
+            spawnDetached('cmd', ['/c', 'start', '', 'chromium', appArgument, '--new-window']));
+    }
+    const appArgument = `--app=${url}`;
+    return (spawnDetached('google-chrome', [appArgument, '--new-window']) ||
+        spawnDetached('chromium-browser', [appArgument, '--new-window']) ||
+        spawnDetached('chromium', [appArgument, '--new-window']) ||
+        spawnDetached('microsoft-edge', [appArgument, '--new-window']) ||
+        spawnDetached('microsoft-edge-stable', [appArgument, '--new-window']));
+};
 const openUrlInBrowser = (url) => {
     const openDisabled = process.env.BRAINLINK_NO_BROWSER === '1' ||
         process.env.BRAINLINK_NO_BROWSER === 'true' ||
         process.env.CI === 'true';
     if (openDisabled) {
-        return;
+        return { opened: false, mode: 'none' };
+    }
+    if (openGraphInAppWindow(url)) {
+        return { opened: true, mode: 'app-window' };
     }
     try {
         if (platform() === 'darwin') {
-            const child = spawn('open', [url], { detached: true, stdio: 'ignore' });
-            child.unref();
-            return;
+            return { opened: spawnDetached('open', [url]), mode: 'browser' };
         }
         if (platform() === 'win32') {
-            const child = spawn('cmd', ['/c', 'start', '', url], { detached: true, stdio: 'ignore' });
-            child.unref();
-            return;
+            return { opened: spawnDetached('cmd', ['/c', 'start', '', url]), mode: 'browser' };
         }
-        const child = spawn('xdg-open', [url], { detached: true, stdio: 'ignore' });
-        child.unref();
+        return { opened: spawnDetached('xdg-open', [url]), mode: 'browser' };
+    }
+    catch {
+        return { opened: false, mode: 'none' };
     }
-    catch { }
 };
 export const registerWriteCommands = (program) => {
     program
@@ -251,10 +291,20 @@ export const registerWriteCommands = (program) => {
             shouldIndex: options.index,
             shouldWatch: Boolean(options.watch)
         });
-        if (options.open !== false) {
-            openUrlInBrowser(server.url);
-        }
-        print(options.json, { url: server.url, watch: Boolean(options.watch), readonly: true, openedInBrowser: options.open !== false }, () => `Brainlink graph server running at ${server.url}${options.open !== false ? ' (opened in browser)' : ''}`);
+        const openResult = options.open !== false ? openUrlInBrowser(server.url) : { opened: false, mode: 'none' };
+        print(options.json, {
+            url: server.url,
+            watch: Boolean(options.watch),
+            readonly: true,
+            openedUi: openResult.opened,
+            openMode: openResult.mode
+        }, () => `Brainlink graph server running at ${server.url}${openResult.opened
+            ? openResult.mode === 'app-window'
+                ? ' (opened in dedicated app window)'
+                : ' (opened in browser)'
+            : options.open === false
+                ? ' (auto-open disabled)'
+                : ''}`);
     });
     program
         .command('quickstart')

package/docs/AGENT_USAGE.md

@@ -540,7 +540,8 @@ blink server --vault ./vault --host 127.0.0.1 --port 4321 --no-open
 ```
 
 This starts a local frontend for inspecting the knowledge graph.
-By default it opens the graph URL in your default browser. Use `--no-open` to keep the server headless.
+By default it tries to open the graph in a dedicated app window and falls back to the default browser when app-window mode is unavailable.
+Use `--no-open` to keep the server headless.
 
 Without `--vault`, the graph UI serves `$HOME/.brainlink/vault`.
 

package/package.json

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