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

package/README.md

@@ -553,6 +553,7 @@ 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.
 
 The graph UI shows:
 
@@ -838,9 +839,11 @@ 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 opens the graph URL in your default browser. 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,8 @@
 import { readFileSync } from 'node:fs';
 import { mkdir, writeFile } from 'node:fs/promises';
 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 +26,29 @@ const resolveAddContent = (options) => {
     }
     return readFileSync(options.contentFile, 'utf8');
 };
+const openUrlInBrowser = (url) => {
+    const openDisabled = process.env.BRAINLINK_NO_BROWSER === '1' ||
+        process.env.BRAINLINK_NO_BROWSER === 'true' ||
+        process.env.CI === 'true';
+    if (openDisabled) {
+        return;
+    }
+    try {
+        if (platform() === 'darwin') {
+            const child = spawn('open', [url], { detached: true, stdio: 'ignore' });
+            child.unref();
+            return;
+        }
+        if (platform() === 'win32') {
+            const child = spawn('cmd', ['/c', 'start', '', url], { detached: true, stdio: 'ignore' });
+            child.unref();
+            return;
+        }
+        const child = spawn('xdg-open', [url], { detached: true, stdio: 'ignore' });
+        child.unref();
+    }
+    catch { }
+};
 export const registerWriteCommands = (program) => {
     program
         .command('init')
@@ -213,6 +238,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 +251,10 @@ 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}`);
+        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)' : ''}`);
     });
     program
         .command('quickstart')

package/docs/AGENT_USAGE.md

@@ -536,9 +536,11 @@ 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 opens the graph URL in your default browser. 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.32",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",