pi-neutrasearch 0.2.0 → 0.2.1

package/README.md

@@ -20,7 +20,13 @@ Inside Pi, run:
 /neutrasearch-setup
 ```
 
-This opens the bundled Neutrasearch app. Approve local indexing there, then return to Pi. Indexing remains an explicit user action; package installation never scans disks or requests privileges.
+This installs convenient shortcuts and opens the bundled Neutrasearch app:
+
+- Linux: application menu, Desktop, and `~/.local/bin` CLI links
+- Windows: Start Menu and Desktop shortcuts
+- macOS: `~/Applications/Neutrasearch.app` and a Desktop alias
+
+Approve local indexing in the app, then return to Pi. Indexing remains an explicit user action; package installation never scans disks or requests privileges.
 
 Use `/neutrasearch` to inspect installation and index status.
 

package/assets/neutrasearch.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect width="64" height="64" rx="11" fill="#111512"/>
+  <path d="M16 17h23l9 9v21H16z" fill="#1d241f" stroke="#a8ff60" stroke-width="3"/>
+  <path d="M39 17v10h9" fill="none" stroke="#a8ff60" stroke-width="3"/>
+  <circle cx="29" cy="36" r="8" fill="none" stroke="#f2f5f1" stroke-width="3"/>
+  <path d="m35 42 8 8" stroke="#f2f5f1" stroke-width="4" stroke-linecap="square"/>
+</svg>

package/index.js

@@ -1,4 +1,5 @@
 import { spawn } from "node:child_process";
+import { installShortcuts } from "./shortcuts.js";
 import {
   compactSearchResult,
   limits,
@@ -181,13 +182,17 @@ export default function register(pi) {
         return;
       }
       try {
+        const shortcuts = installShortcuts(application);
         const child = spawn(application, [], {
           detached: true,
           stdio: "ignore",
           windowsHide: false,
         });
         child.unref();
-        ctx.ui.notify("Neutrasearch opened. Approve local indexing in the app, then return to Pi.", "info");
+        ctx.ui.notify(
+          `Neutrasearch opened and ${shortcuts.length} shortcuts were installed. Approve local indexing in the app, then return to Pi.`,
+          "info",
+        );
       } catch (error) {
         ctx.ui.notify(`Could not open Neutrasearch: ${shortError(error)}`, "error");
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-neutrasearch",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Token-efficient native indexed filename and path search for Pi agents",
   "type": "module",
   "license": "MIT",
@@ -25,6 +25,8 @@
   "files": [
     "index.js",
     "lib.js",
+    "shortcuts.js",
+    "assets",
     "README.md",
     "LICENSE",
     "skills"

package/shortcuts.js

@@ -0,0 +1,123 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+function quoteDesktop(value) {
+  return `"${String(value).replace(/(["`$\\])/g, "\\$1")}"`;
+}
+
+function shellQuote(value) {
+  return `'${String(value).replaceAll("'", "'\\''")}'`;
+}
+
+function writeExecutable(file, content) {
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, content, { mode: 0o755 });
+  fs.chmodSync(file, 0o755);
+}
+
+function installLinux(application, home, packageRoot) {
+  const binRoot = path.dirname(application);
+  const icon = path.join(packageRoot, "assets", "neutrasearch.svg");
+  const applications = path.join(home, ".local", "share", "applications");
+  const desktopEntry = path.join(applications, "neutrasearch.desktop");
+  fs.mkdirSync(applications, { recursive: true });
+  const content = [
+    "[Desktop Entry]",
+    "Type=Application",
+    "Version=1.0",
+    "Name=Neutrasearch",
+    "GenericName=Indexed File Search",
+    "Comment=Search indexed filenames and paths without walking folders",
+    `Exec=${quoteDesktop(application)}`,
+    `Icon=${icon}`,
+    "Terminal=false",
+    "Categories=Utility;FileTools;System;",
+    "Keywords=search;files;index;filename;",
+    "StartupNotify=true",
+    "StartupWMClass=neutrasearch",
+    "",
+  ].join("\n");
+  writeExecutable(desktopEntry, content);
+
+  const created = [desktopEntry];
+  const desktop = path.join(home, "Desktop");
+  if (fs.existsSync(desktop)) {
+    const desktopShortcut = path.join(desktop, "Neutrasearch.desktop");
+    writeExecutable(desktopShortcut, content);
+    created.push(desktopShortcut);
+  }
+
+  const localBin = path.join(home, ".local", "bin");
+  fs.mkdirSync(localBin, { recursive: true });
+  for (const name of ["neutrasearch", "neutrasearch-query", "neutrasearch-helper", "neutrasearch-mcp"]) {
+    const source = path.join(binRoot, name);
+    if (!fs.existsSync(source)) continue;
+    const destination = path.join(localBin, name);
+    try { fs.rmSync(destination, { force: true }); } catch {}
+    fs.symlinkSync(source, destination);
+    created.push(destination);
+  }
+  return created;
+}
+
+function installWindows(application, home, runPowerShell) {
+  const script = [
+    "$ErrorActionPreference = 'Stop'",
+    "$shell = New-Object -ComObject WScript.Shell",
+    "$targets = @(",
+    "  [Environment]::GetFolderPath('Programs') + '\\Neutrasearch.lnk',",
+    "  [Environment]::GetFolderPath('Desktop') + '\\Neutrasearch.lnk'",
+    ")",
+    "foreach ($target in $targets) {",
+    "  $shortcut = $shell.CreateShortcut($target)",
+    "  $shortcut.TargetPath = $env:NEUTRASEARCH_APP",
+    "  $shortcut.WorkingDirectory = Split-Path $env:NEUTRASEARCH_APP",
+    "  $shortcut.IconLocation = $env:NEUTRASEARCH_APP",
+    "  $shortcut.Description = 'Indexed filename and path search'",
+    "  $shortcut.Save()",
+    "}",
+  ].join("\n");
+  runPowerShell("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], {
+    env: { ...process.env, HOME: home, NEUTRASEARCH_APP: application },
+    stdio: "ignore",
+  });
+  return ["Windows Start Menu/Neutrasearch.lnk", "Windows Desktop/Neutrasearch.lnk"];
+}
+
+function installMac(application, home) {
+  const app = path.join(home, "Applications", "Neutrasearch.app");
+  const contents = path.join(app, "Contents");
+  const launcher = path.join(contents, "MacOS", "Neutrasearch");
+  writeExecutable(launcher, `#!/bin/sh\nexec ${shellQuote(application)} "$@"\n`);
+  fs.writeFileSync(
+    path.join(contents, "Info.plist"),
+    `<?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n<plist version="1.0"><dict><key>CFBundleName</key><string>Neutrasearch</string><key>CFBundleDisplayName</key><string>Neutrasearch</string><key>CFBundleIdentifier</key><string>dev.pi.neutrasearch</string><key>CFBundleExecutable</key><string>Neutrasearch</string><key>CFBundlePackageType</key><string>APPL</string></dict></plist>\n`,
+  );
+  const created = [app];
+  const desktop = path.join(home, "Desktop");
+  if (fs.existsSync(desktop)) {
+    const link = path.join(desktop, "Neutrasearch.app");
+    try { fs.rmSync(link, { recursive: true, force: true }); } catch {}
+    fs.symlinkSync(app, link);
+    created.push(link);
+  }
+  return created;
+}
+
+export function installShortcuts(application, options = {}) {
+  if (!application || !path.isAbsolute(application) || !fs.existsSync(application)) {
+    throw new Error("Neutrasearch application is missing");
+  }
+  const platform = options.platform || process.platform;
+  const home = options.home || os.homedir();
+  const packageRoot = options.packageRoot || path.dirname(fileURLToPath(import.meta.url));
+  if (platform === "linux") return installLinux(application, home, packageRoot);
+  if (platform === "win32") {
+    return installWindows(application, home, options.runPowerShell || execFileSync);
+  }
+  if (platform === "darwin") return installMac(application, home);
+  throw new Error(`shortcut installation is unsupported on ${platform}`);
+}