@jx0/jmux 0.5.2 → 0.5.4

package/README.md

@@ -22,7 +22,9 @@ bun install -g @jx0/jmux
 jmux
 ```
 
-Requires [Bun](https://bun.sh) 1.2+, [tmux](https://github.com/tmux/tmux) 3.2+, [fzf](https://github.com/junegunn/fzf), and optionally [git](https://git-scm.com/) for branch display.
+Requires [Bun](https://bun.sh) 1.2+, [tmux](https://github.com/tmux/tmux) 3.2+, [fzf](https://github.com/junegunn/fzf), and optionally [git](https://git-scm.com/) for branch display. jmux will offer to install tmux and fzf for you on first run.
+
+New to tmux? See the **[Getting Started guide](docs/getting-started.md)** — no prior tmux knowledge needed.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jx0/jmux",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "The terminal workspace for agentic development",
   "type": "module",
   "bin": {

package/src/main.ts

@@ -12,7 +12,7 @@ import { homedir } from "os";
 
 // --- CLI commands (run and exit before TUI) ---
 
-const VERSION = "0.5.2";
+const VERSION = "0.5.4";
 
 const HELP = `jmux — the terminal workspace for agentic development
 
@@ -58,12 +58,6 @@ if (process.argv.includes("-v") || process.argv.includes("--version")) {
   process.exit(0);
 }
 
-if (process.env.JMUX) {
-  console.error("Already running inside jmux.");
-  process.exit(1);
-}
-process.env.JMUX = "1";
-
 if (process.argv.includes("--install-agent-hooks")) {
   installAgentHooks();
   process.exit(0);
@@ -122,6 +116,14 @@ function installAgentHooks(): void {
   console.log("will show an orange ! on that session.");
 }
 
+// --- Nesting guard (after CLI commands, before TUI) ---
+
+if (process.env.JMUX) {
+  console.error("Already running inside jmux.");
+  process.exit(1);
+}
+process.env.JMUX = "1";
+
 // --- TUI startup ---
 
 // Read sidebar width from user config, fall back to default
@@ -164,6 +166,69 @@ for (let i = 2; i < process.argv.length; i++) {
     process.exit(1);
   }
 }
+// Preflight checks — offer to install missing dependencies
+async function preflight(): Promise<void> {
+  const missing: string[] = [];
+  if (Bun.spawnSync(["tmux", "-V"], { stdout: "pipe", stderr: "pipe" }).exitCode !== 0) {
+    missing.push("tmux");
+  }
+  if (Bun.spawnSync(["fzf", "--version"], { stdout: "pipe", stderr: "pipe" }).exitCode !== 0) {
+    missing.push("fzf");
+  }
+  if (missing.length === 0) return;
+
+  const isMac = process.platform === "darwin";
+  const hasBrew = isMac && Bun.spawnSync(["brew", "--version"], { stdout: "pipe", stderr: "pipe" }).exitCode === 0;
+  const hasApt = !isMac && Bun.spawnSync(["apt", "--version"], { stdout: "pipe", stderr: "pipe" }).exitCode === 0;
+
+  console.log(`\njmux requires ${missing.join(" and ")} to run.\n`);
+
+  if (hasBrew || hasApt) {
+    const pm = hasBrew ? "brew" : "sudo apt";
+    const installCmd = `${pm} install ${missing.join(" ")}`;
+    console.log(`Install with:\n\n  ${installCmd}\n`);
+
+    // Prompt to install
+    process.stdout.write("Install now? [Y/n] ");
+    const response = await new Promise<string>((resolve) => {
+      process.stdin.setRawMode?.(false);
+      process.stdin.resume();
+      process.stdin.once("data", (data) => {
+        process.stdin.pause();
+        resolve(data.toString().trim().toLowerCase());
+      });
+    });
+
+    if (response === "" || response === "y" || response === "yes") {
+      console.log(`\nRunning: ${installCmd}\n`);
+      const args = hasBrew
+        ? ["brew", "install", ...missing]
+        : ["sudo", "apt", "install", "-y", ...missing];
+      const result = Bun.spawnSync(args, { stdout: "inherit", stderr: "inherit" });
+      if (result.exitCode !== 0) {
+        console.error("\nInstallation failed. Please install manually and try again.");
+        process.exit(1);
+      }
+      console.log("\nDependencies installed. Starting jmux...\n");
+      return;
+    }
+  } else {
+    // No package manager detected — just show instructions
+    if (isMac) {
+      console.log("Install Homebrew first: https://brew.sh");
+      console.log(`Then run: brew install ${missing.join(" ")}`);
+    } else {
+      console.log(`Install with your package manager, e.g.:`);
+      console.log(`  apt install ${missing.join(" ")}`);
+      console.log(`  dnf install ${missing.join(" ")}`);
+      console.log(`  pacman -S ${missing.join(" ")}`);
+    }
+  }
+
+  process.exit(1);
+}
+await preflight();
+
 const cols = process.stdout.columns || 80;
 const rows = process.stdout.rows || 24;
 const sidebarVisible = cols >= 80;