@term-hub/term-hub 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,48 @@
+# Terminal Hub
+
+**Terminal mission control.** Capture every interactive shell you open (Terminal.app, iTerm, VS Code, tmux panes, …) and manage them all from one desktop app — plus spawn your own, independent of any terminal.
+
+Capture is **opt-in, consent-gated, and fully reversible**. Nothing is captured until you say yes; one command reverts everything.
+
+> A terminal you kill from Terminal Hub really dies. A hub-owned session you spawn keeps running until you kill it. The background router can crash and **your shells survive** — there's no system-wide single point of failure.
+
+Full docs, architecture, and source: **https://github.com/AayushGour/terminal-hub**
+
+## Install
+
+```bash
+npm i -g @term-hub/term-hub
+```
+
+This installs the `term-hub` and `hub` commands and registers a launcher in your OS apps menu (Launchpad/Spotlight on macOS, the app grid on Linux, the Start Menu on Windows).
+
+## Usage
+
+- **Launch the GUI:** run `term-hub`, or click **Terminal Hub** in your apps menu.
+- **Enable capture:** on first launch, click **Enable** — then open a new terminal and it shows up automatically.
+- **Manage from the CLI:**
+  ```bash
+  hub status              # list live sessions (healthy / ghost / orphan)
+  hub kill <id>            # end a session's shell
+  hub update               # swap in a freshly built hub, in place, without dropping live sessions
+  hub uninstall            # revert everything
+  ```
+
+## Platform notes
+
+- **macOS:** the launcher isn't quarantined, so there's no Gatekeeper warning and no code-signing needed.
+- **Linux:** the GUI needs the webkit runtime — if the window doesn't open, `sudo apt install libwebkit2gtk-4.1-0` (Debian/Ubuntu) or `sudo dnf install webkit2gtk4.1` (Fedora).
+- **Windows:** GUI binaries are on the roadmap; not yet published.
+
+`npm i -g @term-hub/term-hub` pulls in exactly one platform-specific binary package (`@term-hub/darwin-arm64`, `@term-hub/darwin-x64`, `@term-hub/linux-x64`, or `@term-hub/linux-arm64`) via `optionalDependencies` — npm resolves this automatically based on your OS/CPU, so you never download binaries for a platform you're not on.
+
+## Uninstall
+
+```bash
+hub uninstall            # revert the shell-rc capture hook, stop the background daemon, delete ~/.hub
+npm rm -g @term-hub/term-hub   # remove the CLI + apps-menu entry
+```
+
+## License
+
+MIT

package/bin/term-hub.js

@@ -1,21 +1,38 @@
 #!/usr/bin/env node
-// Launch the Terminal Hub GUI. Detaches so the terminal returns immediately.
+// Launch the Terminal Hub GUI (the real installed bundle -- postinstall.js
+// puts it at a fixed location per platform, it is NOT shipped as a raw
+// binary inside this npm package anymore, see Task 11's D1 change).
 "use strict";
 
 const { spawn } = require("child_process");
-const { exe } = require("../lib/resolve");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
 
-let bin;
-try {
-  bin = exe("hub-app");
-} catch (e) {
-  console.error(String(e.message || e));
-  process.exit(1);
+function launchDarwin() {
+  const appPath = path.join(os.homedir(), "Applications", "Terminal Hub.app");
+  if (!fs.existsSync(appPath)) {
+    console.error(
+      `Terminal Hub: the app isn't installed at ${appPath}. Retry the GUI install with a fresh \`npm install -g @term-hub/term-hub\`.`
+    );
+    process.exit(1);
+  }
+  const extraArgs = process.argv.slice(2);
+  return spawn("open", [appPath, ...(extraArgs.length ? ["--args", ...extraArgs] : [])], {
+    stdio: "ignore",
+    detached: true,
+  });
 }
 
-// On Linux the GUI needs the webkit2gtk runtime; hint if it's obviously missing.
-if (process.platform === "linux") {
-  const fs = require("fs");
+function launchLinux() {
+  const appImagePath = path.join(os.homedir(), ".local", "share", "term-hub", "hub-app.AppImage");
+  if (!fs.existsSync(appImagePath)) {
+    console.error(
+      `Terminal Hub: the app isn't installed at ${appImagePath}. Retry the GUI install with a fresh \`npm install -g @term-hub/term-hub\`.`
+    );
+    process.exit(1);
+  }
+  // Same webkit2gtk hint as before -- the AppImage needs it at runtime.
   const hasWebkit = ["/usr/lib", "/usr/lib/x86_64-linux-gnu", "/usr/lib/aarch64-linux-gnu", "/usr/lib64"].some(
     (d) => {
       try {
@@ -32,12 +49,19 @@ if (process.platform === "linux") {
         "  Fedora:         sudo dnf install webkit2gtk4.1"
     );
   }
+  return spawn(appImagePath, process.argv.slice(2), { stdio: "ignore", detached: true });
+}
+
+let child;
+if (process.platform === "darwin") {
+  child = launchDarwin();
+} else if (process.platform === "linux") {
+  child = launchLinux();
+} else {
+  console.error("Terminal Hub: the GUI isn't available on this platform yet.");
+  process.exit(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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@term-hub/term-hub",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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",
@@ -11,9 +11,14 @@
     "terminal-manager",
     "tauri"
   ],
-  "homepage": "https://github.com/your-org/term-hub#readme",
+  "homepage": "https://github.com/AayushGour/terminal-hub#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AayushGour/terminal-hub.git",
+    "directory": "hub/npm/term-hub"
+  },
   "license": "MIT",
-  "author": "TODO your name <ag14906@gmail.com>",
+  "author": "Aayush Gour <ag14906@gmail.com>",
   "type": "commonjs",
   "bin": {
     "term-hub": "bin/term-hub.js",
@@ -31,10 +36,10 @@
   },
   "//": "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"
+    "@term-hub/darwin-arm64": "0.1.1",
+    "@term-hub/darwin-x64": "0.1.1",
+    "@term-hub/linux-x64": "0.1.1",
+    "@term-hub/linux-arm64": "0.1.1"
   },
   "engines": {
     "node": ">=18"