@andespindola/brainlink 0.1.0-beta.30 → 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/application/frontend/client-js.js

@@ -23,6 +23,7 @@ const state = {
   nodeDetails: new Map(),
   transform: { x: 0, y: 0, scale: 1 },
   pointer: { x: 0, y: 0, down: false, dragNode: null, moved: false },
+  cursor: { x: 0, y: 0, inCanvas: false },
   graphSignature: '',
   graphStatus: '',
   last: performance.now()
@@ -687,6 +688,30 @@ const wheelZoomFactor = event => {
   return event.deltaY < 0 ? 1 + adjustedStep : 1 / (1 + adjustedStep)
 }
 
+const isScreenPointInsideCanvas = (screenX, screenY) => {
+  const rect = canvas.getBoundingClientRect()
+
+  return screenX >= rect.left && screenX <= rect.right && screenY >= rect.top && screenY <= rect.bottom
+}
+
+const handleWheelZoom = event => {
+  if (!isScreenPointInsideCanvas(event.clientX, event.clientY)) {
+    return
+  }
+
+  event.preventDefault()
+  const rect = canvas.getBoundingClientRect()
+  const cursorX = event.clientX - rect.left
+  const cursorY = event.clientY - rect.top
+  const factor = wheelZoomFactor(event)
+
+  if (!Number.isFinite(factor) || factor <= 0 || factor === 1) {
+    return
+  }
+
+  zoomAtPoint(cursorX, cursorY, factor)
+}
+
 const bindEvents = () => {
   window.addEventListener('resize', resize)
   elements.search.addEventListener('input', event => {
@@ -730,14 +755,7 @@ const bindEvents = () => {
     }
     if (event.target === elements.contentDialog) elements.contentDialog.close()
   })
-  canvas.addEventListener('wheel', event => {
-    event.preventDefault()
-    const rect = canvas.getBoundingClientRect()
-    const cursorX = event.clientX - rect.left
-    const cursorY = event.clientY - rect.top
-    const factor = wheelZoomFactor(event)
-    zoomAtPoint(cursorX, cursorY, factor)
-  }, { passive: false })
+  window.addEventListener('wheel', handleWheelZoom, { passive: false })
   canvas.addEventListener('dblclick', event => {
     const rect = canvas.getBoundingClientRect()
     const cursorX = event.clientX - rect.left
@@ -757,6 +775,7 @@ const bindEvents = () => {
   canvas.addEventListener('pointermove', event => {
     const point = worldPoint(event)
     state.hovered = hitNode(point)
+    state.cursor = { x: event.clientX, y: event.clientY, inCanvas: true }
     if (!state.pointer.down) return
     const dx = event.clientX - state.pointer.x
     const dy = event.clientY - state.pointer.y
@@ -780,6 +799,12 @@ const bindEvents = () => {
   canvas.addEventListener('pointercancel', () => {
     state.pointer = { x: 0, y: 0, down: false, dragNode: null, moved: false }
   })
+  canvas.addEventListener('pointerenter', event => {
+    state.cursor = { x: event.clientX, y: event.clientY, inCanvas: true }
+  })
+  canvas.addEventListener('pointerleave', event => {
+    state.cursor = { x: event.clientX, y: event.clientY, inCanvas: false }
+  })
   window.addEventListener('keydown', event => {
     if (event.key === '+' || event.key === '=') {
       event.preventDefault()

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.30",
+  "version": "0.1.0-beta.32",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",