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

package/README.md

@@ -553,6 +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` 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:
 
@@ -838,9 +840,12 @@ Watches Markdown files and rebuilds the index when notes change.
 ```bash
 blink server --watch
 blink server --vault ./vault --watch
+blink server --vault ./vault --watch --no-open
 ```
 
 Starts the local read-only graph UI and HTTP API.
+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,6 +1,9 @@
 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';
 import { addNote } from '../../application/add-note.js';
 import { buildContextPackage } from '../../application/build-context.js';
 import { importLegacySqliteDatabase } from '../../application/import-legacy-sqlite.js';
@@ -24,6 +27,68 @@ 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 { opened: false, mode: 'none' };
+    }
+    if (openGraphInAppWindow(url)) {
+        return { opened: true, mode: 'app-window' };
+    }
+    try {
+        if (platform() === 'darwin') {
+            return { opened: spawnDetached('open', [url]), mode: 'browser' };
+        }
+        if (platform() === 'win32') {
+            return { opened: spawnDetached('cmd', ['/c', 'start', '', url]), mode: 'browser' };
+        }
+        return { opened: spawnDetached('xdg-open', [url]), mode: 'browser' };
+    }
+    catch {
+        return { opened: false, mode: 'none' };
+    }
+};
 export const registerWriteCommands = (program) => {
     program
         .command('init')
@@ -213,6 +278,7 @@ export const registerWriteCommands = (program) => {
         .option('-h, --host <host>', 'server host', '127.0.0.1')
         .option('-p, --port <port>', 'server port', '4321')
         .option('--no-index', 'skip indexing before starting the server')
+        .option('--no-open', 'do not open the graph UI in the default browser')
         .option('-w, --watch', 'watch markdown files and reindex on changes')
         .option('--json', 'print machine-readable JSON')
         .description('start a local web UI for the knowledge graph')
@@ -225,7 +291,20 @@ export const registerWriteCommands = (program) => {
             shouldIndex: options.index,
             shouldWatch: Boolean(options.watch)
         });
-        print(options.json, { url: server.url, watch: Boolean(options.watch), readonly: true }, () => `Brainlink graph server running at ${server.url}`);
+        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

@@ -536,9 +536,12 @@ shared: 30 documents
 ```bash
 blink server --host 127.0.0.1 --port 4321
 blink server --vault ./vault --host 127.0.0.1 --port 4321
+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 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.31",
+  "version": "0.1.0-beta.33",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",