@andespindola/brainlink 0.1.0-beta.35 → 0.1.0-beta.36

package/CHANGELOG.md

@@ -27,6 +27,7 @@
 - Improved graph UI auto-fit and viewport recovery so loaded nodes are re-centered when zoom/pan drifts to empty canvas.
 - Added cross-platform native desktop GUI auto-open for `blink server` (macOS Swift/WebKit, Windows PowerShell WinForms, Linux Python GTK/WebKit2), with app-window/browser fallback.
 - Changed Linux default UI launch to app-window/browser for lighter startup; Linux native GUI is now opt-in via `BRAINLINK_LINUX_NATIVE_GUI=1`.
+- Added native GUI parent-process monitoring so GUI windows close automatically when `blink server` stops.
 
 ## 0.1.0-beta.3
 

package/README.md

@@ -561,6 +561,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.
 Use `--no-open` to keep it headless.
+When native GUI is used, the GUI window automatically closes when the `blink server` process stops.
 
 The graph UI shows:
 

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

@@ -42,14 +42,18 @@ const nativeGuiLinuxScriptPath = join(tmpdir(), 'brainlink-native-gui-linux.py')
 const nativeGuiSwiftScript = `import Foundation
 import AppKit
 import WebKit
+import Darwin
 
 final class BrainlinkAppDelegate: NSObject, NSApplicationDelegate, NSWindowDelegate {
   private let targetUrl: URL
+  private let parentPid: Int32
   private var window: NSWindow?
   private var webView: WKWebView?
+  private var monitorTimer: Timer?
 
-  init(targetUrl: URL) {
+  init(targetUrl: URL, parentPid: Int32) {
     self.targetUrl = targetUrl
+    self.parentPid = parentPid
   }
 
   func applicationDidFinishLaunching(_ notification: Notification) {
@@ -73,16 +77,27 @@ final class BrainlinkAppDelegate: NSObject, NSApplicationDelegate, NSWindowDeleg
     self.window = window
     self.webView = webView
 
+    if parentPid > 0 {
+      monitorTimer = Timer.scheduledTimer(withTimeInterval: 1, repeats: true) { _ in
+        if kill(self.parentPid, 0) != 0 {
+          NSApp.terminate(nil)
+        }
+      }
+    }
+
     window.makeKeyAndOrderFront(nil)
     NSApp.activate(ignoringOtherApps: true)
   }
 
   func windowWillClose(_ notification: Notification) {
+    monitorTimer?.invalidate()
     NSApp.terminate(nil)
   }
 }
 
-let rawTarget = CommandLine.arguments.dropFirst().first ?? "http://127.0.0.1:4321"
+let args = Array(CommandLine.arguments.dropFirst())
+let rawTarget = args.indices.contains(0) ? args[0] : "http://127.0.0.1:4321"
+let parentPid: Int32 = args.indices.contains(1) ? (Int32(args[1]) ?? 0) : 0
 
 guard let targetUrl = URL(string: rawTarget) else {
   fputs("Invalid URL for Brainlink GUI: \\(rawTarget)\\n", stderr)
@@ -91,12 +106,13 @@ guard let targetUrl = URL(string: rawTarget) else {
 
 let app = NSApplication.shared
 app.setActivationPolicy(.regular)
-let delegate = BrainlinkAppDelegate(targetUrl: targetUrl)
+let delegate = BrainlinkAppDelegate(targetUrl: targetUrl, parentPid: parentPid)
 app.delegate = delegate
 app.run()
 `;
 const nativeGuiPowershellScript = `param(
-  [string]$TargetUrl = "http://127.0.0.1:4321"
+  [string]$TargetUrl = "http://127.0.0.1:4321",
+  [int]$ParentPid = 0
 )
 
 Add-Type -AssemblyName System.Windows.Forms
@@ -115,6 +131,23 @@ $browser.ScriptErrorsSuppressed = $true
 $browser.Navigate($TargetUrl)
 
 $form.Controls.Add($browser)
+$timer = New-Object System.Windows.Forms.Timer
+$timer.Interval = 1000
+$timer.Add_Tick({
+  if ($ParentPid -le 0) {
+    return
+  }
+  try {
+    Get-Process -Id $ParentPid -ErrorAction Stop | Out-Null
+  } catch {
+    $timer.Stop()
+    $form.Close()
+  }
+})
+$form.Add_FormClosed({
+  $timer.Stop()
+})
+$timer.Start()
 [void]$form.ShowDialog()
 `;
 const nativeGuiLinuxPythonScript = `#!/usr/bin/env python3
@@ -128,11 +161,12 @@ def run() -> int:
             gi.require_version("WebKit2", "4.1")
         except ValueError:
             gi.require_version("WebKit2", "4.0")
-        from gi.repository import Gtk, WebKit2
+        from gi.repository import Gtk, WebKit2, GLib
     except Exception:
         return 1
 
     target_url = sys.argv[1] if len(sys.argv) > 1 else "http://127.0.0.1:4321"
+    parent_pid = int(sys.argv[2]) if len(sys.argv) > 2 else 0
 
     window = Gtk.Window(title="Brainlink Graph")
     window.set_default_size(1320, 860)
@@ -142,6 +176,19 @@ def run() -> int:
     webview.load_uri(target_url)
     window.add(webview)
     window.show_all()
+
+    if parent_pid > 0:
+        def _watch_parent() -> bool:
+            try:
+                import os
+                os.kill(parent_pid, 0)
+            except Exception:
+                Gtk.main_quit()
+                return False
+            return True
+
+        GLib.timeout_add(1000, _watch_parent)
+
     Gtk.main()
     return 0
 
@@ -174,7 +221,7 @@ const resolveSwiftExecutable = () => {
         return null;
     }
 };
-const openGraphInMacNativeGui = (url) => {
+const openGraphInMacNativeGui = (url, parentPid) => {
     const swiftBinary = resolveSwiftExecutable();
     if (!swiftBinary) {
         return false;
@@ -185,7 +232,7 @@ const openGraphInMacNativeGui = (url) => {
     catch {
         return false;
     }
-    return spawnDetached(swiftBinary, [nativeGuiSwiftScriptPath, url]);
+    return spawnDetached(swiftBinary, [nativeGuiSwiftScriptPath, url, String(parentPid)]);
 };
 const resolveWindowsPowershellExecutable = () => {
     if (commandExists('powershell')) {
@@ -196,7 +243,7 @@ const resolveWindowsPowershellExecutable = () => {
     }
     return null;
 };
-const openGraphInWindowsNativeGui = (url) => {
+const openGraphInWindowsNativeGui = (url, parentPid) => {
     const powershell = resolveWindowsPowershellExecutable();
     if (!powershell) {
         return false;
@@ -207,9 +254,9 @@ const openGraphInWindowsNativeGui = (url) => {
     catch {
         return false;
     }
-    return spawnDetached(powershell, ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-STA', '-File', nativeGuiPowershellScriptPath, url]);
+    return spawnDetached(powershell, ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-STA', '-File', nativeGuiPowershellScriptPath, url, String(parentPid)]);
 };
-const openGraphInLinuxNativeGui = (url) => {
+const openGraphInLinuxNativeGui = (url, parentPid) => {
     if (!commandExists('python3')) {
         return false;
     }
@@ -219,16 +266,16 @@ const openGraphInLinuxNativeGui = (url) => {
     catch {
         return false;
     }
-    return spawnDetached('python3', [nativeGuiLinuxScriptPath, url]);
+    return spawnDetached('python3', [nativeGuiLinuxScriptPath, url, String(parentPid)]);
 };
-const openGraphInNativeGui = (url) => {
+const openGraphInNativeGui = (url, parentPid) => {
     if (platform() === 'darwin') {
-        return openGraphInMacNativeGui(url);
+        return openGraphInMacNativeGui(url, parentPid);
     }
     if (platform() === 'win32') {
-        return openGraphInWindowsNativeGui(url);
+        return openGraphInWindowsNativeGui(url, parentPid);
     }
-    return openGraphInLinuxNativeGui(url);
+    return openGraphInLinuxNativeGui(url, parentPid);
 };
 const openGraphInAppWindow = (url) => {
     if (platform() === 'darwin') {
@@ -259,7 +306,7 @@ const openGraphInAppWindow = (url) => {
         spawnDetached('microsoft-edge', [appArgument, '--new-window']) ||
         spawnDetached('microsoft-edge-stable', [appArgument, '--new-window']));
 };
-const openUrlInUi = (url) => {
+const openUrlInUi = (url, parentPid) => {
     const openDisabled = process.env.BRAINLINK_NO_BROWSER === '1' ||
         process.env.BRAINLINK_NO_BROWSER === 'true' ||
         process.env.CI === 'true';
@@ -269,7 +316,7 @@ const openUrlInUi = (url) => {
     const currentPlatform = platform();
     const nativeGuiEnabled = !envFlagEnabled('BRAINLINK_NO_NATIVE_GUI') &&
         (currentPlatform !== 'linux' || envFlagEnabled('BRAINLINK_LINUX_NATIVE_GUI') || envFlagEnabled('BRAINLINK_FORCE_NATIVE_GUI'));
-    if (nativeGuiEnabled && openGraphInNativeGui(url)) {
+    if (nativeGuiEnabled && openGraphInNativeGui(url, parentPid)) {
         return { opened: true, mode: 'native-gui' };
     }
     if (openGraphInAppWindow(url)) {
@@ -490,7 +537,7 @@ export const registerWriteCommands = (program) => {
             shouldIndex: options.index,
             shouldWatch: Boolean(options.watch)
         });
-        const openResult = options.open !== false ? openUrlInUi(server.url) : { opened: false, mode: 'none' };
+        const openResult = options.open !== false ? openUrlInUi(server.url, process.pid) : { opened: false, mode: 'none' };
         print(options.json, {
             url: server.url,
             watch: Boolean(options.watch),

package/docs/AGENT_USAGE.md

@@ -548,6 +548,7 @@ By default it tries to open the graph in a native desktop GUI window:
 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, it falls back to dedicated app-window mode and then to the default browser.
 Use `--no-open` to keep the server headless.
+When native GUI is active, the GUI window closes automatically when the `blink server` process stops.
 
 Without `--vault`, the graph UI serves `$HOME/.brainlink/vault`.
 

package/package.json

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