@term-hub/term-hub 0.1.0

package/bin/hub.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// Passthrough to the `hub` CLI (install / status / kill / uninstall). Forwards
+// args + stdio and mirrors the exit code.
+"use strict";
+
+const { spawn } = require("child_process");
+const { exe } = require("../lib/resolve");
+
+let bin;
+try {
+  bin = exe("hub");
+} catch (e) {
+  console.error(String(e.message || e));
+  process.exit(1);
+}
+
+const child = spawn(bin, process.argv.slice(2), { stdio: "inherit" });
+child.on("error", (err) => {
+  console.error(`hub: failed to run (${err.message}).`);
+  process.exit(1);
+});
+child.on("exit", (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  else process.exit(code ?? 0);
+});

package/bin/term-hub.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+// Launch the Terminal Hub GUI. Detaches so the terminal returns immediately.
+"use strict";
+
+const { spawn } = require("child_process");
+const { exe } = require("../lib/resolve");
+
+let bin;
+try {
+  bin = exe("hub-app");
+} catch (e) {
+  console.error(String(e.message || e));
+  process.exit(1);
+}
+
+// On Linux the GUI needs the webkit2gtk runtime; hint if it's obviously missing.
+if (process.platform === "linux") {
+  const fs = require("fs");
+  const hasWebkit = ["/usr/lib", "/usr/lib/x86_64-linux-gnu", "/usr/lib/aarch64-linux-gnu", "/usr/lib64"].some(
+    (d) => {
+      try {
+        return fs.readdirSync(d).some((f) => f.startsWith("libwebkit2gtk-4.1"));
+      } catch {
+        return false;
+      }
+    }
+  );
+  if (!hasWebkit) {
+    console.error(
+      "Terminal Hub: the webkit2gtk runtime seems missing. If the window doesn't open, install it:\n" +
+        "  Debian/Ubuntu:  sudo apt install libwebkit2gtk-4.1-0\n" +
+        "  Fedora:         sudo dnf install webkit2gtk4.1"
+    );
+  }
+}
+
+const child = spawn(bin, process.argv.slice(2), {
+  stdio: "ignore",
+  detached: true,
+});
+child.on("error", (err) => {
+  console.error(`Terminal Hub: failed to launch (${err.message}).`);
+  process.exit(1);
+});
+child.unref(); // let the terminal return; the GUI keeps running

package/lib/resolve.js

@@ -0,0 +1,59 @@
+// Resolve the prebuilt binary for the host platform/arch.
+//
+// The binaries live in a per-platform optional dependency
+// (`@term-hub/<platform>-<arch>`); npm only installs the one matching the
+// host (via each package's `os`/`cpu` fields), so exactly one is present.
+"use strict";
+
+const path = require("path");
+
+// Platforms with published prebuilt binaries. Windows (win32-x64) is phase 2 —
+// its package/CI are wired but not built yet, so it's intentionally absent here
+// (Windows users get a clear "in progress" message rather than a broken install).
+const SUPPORTED = new Set([
+  "darwin-arm64",
+  "darwin-x64",
+  "linux-x64",
+  "linux-arm64",
+]);
+
+const KEY = `${process.platform}-${process.arch}`;
+const PKG = `@term-hub/${KEY}`;
+const EXT = process.platform === "win32" ? ".exe" : "";
+
+/** Directory holding the prebuilt binaries for this platform, or null. */
+function binDir() {
+  try {
+    // Resolve the platform package relative to THIS package (works whether
+    // installed globally or locally).
+    const manifest = require.resolve(`${PKG}/package.json`, { paths: [__dirname] });
+    return path.join(path.dirname(manifest), "bin");
+  } catch {
+    return null;
+  }
+}
+
+/** Absolute path to a named binary (e.g. "hub-app", "hub"), or throws a clear error. */
+function exe(name) {
+  if (!SUPPORTED.has(KEY)) {
+    const windows = process.platform === "win32";
+    throw new Error(
+      windows
+        ? `Terminal Hub: Windows support is in progress — no prebuilt binary yet.\n` +
+            `Track it: https://github.com/your-org/term-hub#roadmap--vision`
+        : `Terminal Hub: no prebuilt binary for ${KEY}.\n` +
+            `Supported: ${[...SUPPORTED].join(", ")}.\n` +
+            `See: https://github.com/your-org/term-hub#platform-support`
+    );
+  }
+  const dir = binDir();
+  if (!dir) {
+    throw new Error(
+      `Terminal Hub: the binary package ${PKG} isn't installed.\n` +
+        `Reinstall with:  npm install -g @term-hub/term-hub  (optional deps must be allowed)`
+    );
+  }
+  return path.join(dir, name + EXT);
+}
+
+module.exports = { KEY, PKG, SUPPORTED, binDir, exe };

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@term-hub/term-hub",
+  "version": "0.1.0",
+  "description": "Terminal Hub — capture every terminal you open and manage them all from one window. One-command cross-platform install (macOS / Linux / Windows).",
+  "keywords": [
+    "terminal",
+    "tmux",
+    "pty",
+    "shell",
+    "tui",
+    "terminal-manager",
+    "tauri"
+  ],
+  "homepage": "https://github.com/your-org/term-hub#readme",
+  "license": "MIT",
+  "author": "TODO your name <ag14906@gmail.com>",
+  "type": "commonjs",
+  "bin": {
+    "term-hub": "bin/term-hub.js",
+    "hub": "bin/hub.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "scripts",
+    "assets"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "preuninstall": "node scripts/preuninstall.js"
+  },
+  "//": "optionalDependencies: npm installs ONLY the package whose os/cpu matches the host, so a mac user downloads just the darwin binaries, etc. Versions are kept in lockstep with this package and bumped together by CI.",
+  "optionalDependencies": {
+    "@term-hub/darwin-arm64": "0.1.0",
+    "@term-hub/darwin-x64": "0.1.0",
+    "@term-hub/linux-x64": "0.1.0",
+    "@term-hub/linux-arm64": "0.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+// Register a desktop launcher so Terminal Hub shows up in the OS apps menu
+// (Launchpad / Linux app grid / Start Menu) and is clickable, not just runnable
+// from a terminal. Best-effort: any failure here never fails `npm install`.
+"use strict";
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const NAME = "Terminal Hub";
+const pkgDir = path.resolve(__dirname, "..");
+const assets = path.join(pkgDir, "assets");
+
+function safe(label, fn) {
+  try {
+    fn();
+  } catch (e) {
+    console.error(`Terminal Hub: could not register ${label} (${e.message}). You can still run \`term-hub\`.`);
+  }
+}
+
+// Resolve the GUI binary for this platform; if there isn't one, there's nothing
+// to register (e.g. optional deps were skipped, or unsupported platform).
+let appBin = null;
+try {
+  const p = require("../lib/resolve").exe("hub-app");
+  if (fs.existsSync(p)) appBin = p;
+} catch {
+  /* no binary for this platform */
+}
+if (!appBin) process.exit(0);
+
+if (process.platform === "darwin") registerMac();
+else if (process.platform === "linux") registerLinux();
+else if (process.platform === "win32") registerWindows();
+
+function registerMac() {
+  safe("the Applications entry", () => {
+    const appDir = path.join(os.homedir(), "Applications", `${NAME}.app`);
+    const macos = path.join(appDir, "Contents", "MacOS");
+    const res = path.join(appDir, "Contents", "Resources");
+    fs.mkdirSync(macos, { recursive: true });
+    fs.mkdirSync(res, { recursive: true });
+
+    const launcher = path.join(macos, "term-hub");
+    fs.writeFileSync(launcher, `#!/bin/sh\nexec "${appBin}" "$@"\n`);
+    fs.chmodSync(launcher, 0o755);
+
+    const icns = path.join(assets, "icon.icns");
+    if (fs.existsSync(icns)) fs.copyFileSync(icns, path.join(res, "icon.icns"));
+
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>CFBundleName</key><string>${NAME}</string>
+  <key>CFBundleDisplayName</key><string>${NAME}</string>
+  <key>CFBundleIdentifier</key><string>dev.hub.launcher</string>
+  <key>CFBundleExecutable</key><string>term-hub</string>
+  <key>CFBundleIconFile</key><string>icon</string>
+  <key>CFBundlePackageType</key><string>APPL</string>
+</dict></plist>
+`;
+    fs.writeFileSync(path.join(appDir, "Contents", "Info.plist"), plist);
+    // A launcher .app created locally (not downloaded) isn't quarantined, so it
+    // opens with no Gatekeeper warning.
+    console.log(`Terminal Hub: added to ~/Applications — find it in Launchpad/Spotlight.`);
+  });
+}
+
+function registerLinux() {
+  safe("the applications menu entry", () => {
+    const appsDir = path.join(os.homedir(), ".local", "share", "applications");
+    const iconsDir = path.join(os.homedir(), ".local", "share", "icons");
+    fs.mkdirSync(appsDir, { recursive: true });
+    fs.mkdirSync(iconsDir, { recursive: true });
+
+    const png = path.join(assets, "icon.png");
+    let icon = "utilities-terminal";
+    if (fs.existsSync(png)) {
+      fs.copyFileSync(png, path.join(iconsDir, "term-hub.png"));
+      icon = "term-hub";
+    }
+
+    const desktop = `[Desktop Entry]
+Type=Application
+Name=${NAME}
+Comment=Capture and manage all your terminals
+Exec="${appBin}" %U
+Icon=${icon}
+Terminal=false
+Categories=Utility;System;TerminalEmulator;
+`;
+    fs.writeFileSync(path.join(appsDir, "term-hub.desktop"), desktop);
+    console.log("Terminal Hub: added to your applications menu.");
+  });
+}
+
+function registerWindows() {
+  safe("the Start Menu shortcut", () => {
+    const { execFileSync } = require("child_process");
+    const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
+    const startMenu = path.join(appData, "Microsoft", "Windows", "Start Menu", "Programs");
+    fs.mkdirSync(startMenu, { recursive: true });
+    const lnk = path.join(startMenu, `${NAME}.lnk`);
+    const ico = path.join(assets, "icon.ico");
+    const q = (s) => s.replace(/'/g, "''");
+    const ps =
+      `$s=(New-Object -ComObject WScript.Shell).CreateShortcut('${q(lnk)}');` +
+      `$s.TargetPath='${q(appBin)}';` +
+      (fs.existsSync(ico) ? `$s.IconLocation='${q(ico)}';` : "") +
+      `$s.Save()`;
+    execFileSync("powershell", ["-NoProfile", "-NonInteractive", "-Command", ps], { stdio: "ignore" });
+    console.log("Terminal Hub: added to the Start Menu.");
+  });
+}

package/scripts/preuninstall.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// Remove the desktop launcher created by postinstall.js on `npm rm -g`.
+// Best-effort; never throws.
+"use strict";
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const NAME = "Terminal Hub";
+const rm = (p) => {
+  try {
+    fs.rmSync(p, { recursive: true, force: true });
+  } catch {
+    /* ignore */
+  }
+};
+
+if (process.platform === "darwin") {
+  rm(path.join(os.homedir(), "Applications", `${NAME}.app`));
+} else if (process.platform === "linux") {
+  rm(path.join(os.homedir(), ".local", "share", "applications", "term-hub.desktop"));
+  rm(path.join(os.homedir(), ".local", "share", "icons", "term-hub.png"));
+} else if (process.platform === "win32") {
+  const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
+  rm(path.join(appData, "Microsoft", "Windows", "Start Menu", "Programs", `${NAME}.lnk`));
+}