@jx0/jmux 0.5.1 → 0.5.3

package/README.md

@@ -4,7 +4,9 @@
 
 **The terminal workspace for agentic development.**
 
-Run coding agents in parallel from your terminal. A persistent sidebar shows every session, what's running, and what needs your attention — without leaving the tools you already use.
+Agents, editors, servers, logs. All running. All visible. One terminal.
+
+Run Claude Code, Codex, or aider in parallel — jmux shows you which agents are working, which finished, and which need your review. No Electron. No lock-in. Just your terminal.
 
 [![npm](https://img.shields.io/npm/v/@jx0/jmux)](https://www.npmjs.com/package/@jx0/jmux)
 [![license](https://img.shields.io/github/license/jarredkenny/jmux)](LICENSE)

package/package.json

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

package/src/main.ts

@@ -12,9 +12,16 @@ import { homedir } from "os";
 
 // --- CLI commands (run and exit before TUI) ---
 
-const VERSION = "0.5.1";
+const VERSION = "0.5.3";
 
-const HELP = `jmux — a persistent session sidebar for tmux
+const HELP = `jmux — the terminal workspace for agentic development
+
+Agents, editors, servers, logs.
+All running. All visible. One terminal.
+
+Run Claude Code, Codex, or aider in parallel — jmux shows you which
+agents are working, which finished, and which need your review.
+No Electron. No lock-in. Just your terminal.
 
 Usage:
   jmux [session-name] [options]
@@ -33,10 +40,13 @@ Examples:
 
 Keybindings:
   Ctrl-Shift-Up/Down       Switch sessions
-  Ctrl-a n                 New session (directory picker)
+  Ctrl-a n                 New session / worktree
+  Ctrl-a i                 Settings
   Ctrl-a j                 Window picker (fzf)
   Ctrl-a c                 New window
-  Click sidebar            Switch to session`;
+  Click sidebar            Switch to session
+
+https://github.com/jarredkenny/jmux`;
 
 if (process.argv.includes("-h") || process.argv.includes("--help")) {
   console.log(HELP);
@@ -154,6 +164,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;
@@ -591,6 +664,7 @@ async function start(): Promise<void> {
   // we attached to an existing server that loaded ~/.tmux.conf
   // Set JMUX_DIR in tmux's global environment so config bindings can reference it
   await control.sendCommand(`set-environment -g JMUX_DIR ${jmuxDir}`);
+  await control.sendCommand("set-environment -g JMUX 1");
   await control.sendCommand(`source-file ${configFile}`);
   // Re-enable automatic-rename on all windows — clears any application-set names
   try {