numux 2.13.1 → 2.14.0

package/README.md

@@ -477,14 +477,19 @@ Keybindings are shown in the status bar at the bottom of the app. Panes are read
 <!-- generated:keybindings -->
 | Key | Action |
 |-----|--------|
-| `←`/`→` or `1`-`9` | Tabs |
-| `G/Shift+G` | Top/bottom |
+| `←`/`→` or `1`-`9` | Switch tabs |
+| `Enter` | Input mode |
+| `F` | Search |
 | `R` | Restart |
+| `Shift+R` | Restart all |
 | `S` | Stop/start |
-| `F` | Search |
 | `Y` | Copy all |
 | `L` | Clear |
 | `T` | Timestamps |
+| `↑↓` | Scroll line |
+| `Shift+↑↓` | Top/bottom |
+| `G/Shift+G` | Top/bottom |
+| `PgUp/PgDn` | Scroll page |
 | `O` | Open logs |
 | `Ctrl+Click` | Open link |
 | `Ctrl+C` | Quit |

package/dist/man/numux.1

@@ -1,4 +1,4 @@
-.TH "NUMUX" "1" "April 2026" "2.13.1" "numux manual"
+.TH "NUMUX" "1" "April 2026" "2.14.0" "numux manual"
 .SH "NAME"
 \fBnumux\fR
 .P
@@ -949,13 +949,19 @@ T}
 T{
 \fB←\fP/\fB→\fP or \fB1\fP\-\fB9\fP
 T}|T{
-Tabs
+Switch tabs
 T}
 _
 T{
-\fBG/Shift+G\fP
+\fBEnter\fP
 T}|T{
-Top/bottom
+Input mode
+T}
+_
+T{
+\fBF\fP
+T}|T{
+Search
 T}
 _
 T{
@@ -965,15 +971,15 @@ Restart
 T}
 _
 T{
-\fBS\fP
+\fBShift+R\fP
 T}|T{
-Stop/start
+Restart all
 T}
 _
 T{
-\fBF\fP
+\fBS\fP
 T}|T{
-Search
+Stop/start
 T}
 _
 T{
@@ -995,6 +1001,30 @@ Timestamps
 T}
 _
 T{
+\fB↑↓\fP
+T}|T{
+Scroll line
+T}
+_
+T{
+\fBShift+↑↓\fP
+T}|T{
+Top/bottom
+T}
+_
+T{
+\fBG/Shift+G\fP
+T}|T{
+Top/bottom
+T}
+_
+T{
+\fBPgUp/PgDn\fP
+T}|T{
+Scroll page
+T}
+_
+T{
 \fBO\fP
 T}|T{
 Open logs

package/dist/numux.js

@@ -456,14 +456,19 @@ Unmatched references are left as-is (the shell will expand \`$db\` as empty + \`
 <!-- generated:keybindings -->
 | Key | Action |
 |-----|--------|
-| \`\u2190\`/\`\u2192\` or \`1\`-\`9\` | Tabs |
-| \`G/Shift+G\` | Top/bottom |
+| \`\u2190\`/\`\u2192\` or \`1\`-\`9\` | Switch tabs |
+| \`Enter\` | Input mode |
+| \`F\` | Search |
 | \`R\` | Restart |
+| \`Shift+R\` | Restart all |
 | \`S\` | Stop/start |
-| \`F\` | Search |
 | \`Y\` | Copy all |
 | \`L\` | Clear |
 | \`T\` | Timestamps |
+| \`\u2191\u2193\` | Scroll line |
+| \`Shift+\u2191\u2193\` | Top/bottom |
+| \`G/Shift+G\` | Top/bottom |
+| \`PgUp/PgDn\` | Scroll page |
 | \`O\` | Open logs |
 | \`Ctrl+Click\` | Open link |
 | \`Ctrl+C\` | Quit |
@@ -541,7 +546,7 @@ var init_help = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "2.13.1",
+    version: "2.14.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -2500,9 +2505,7 @@ class ProcessRunner {
     }
   }
   write(data) {
-    if (this.config.interactive && this.proc?.terminal) {
-      this.proc.terminal.write(data);
-    }
+    this.proc?.terminal?.write(data);
   }
 }
 
@@ -2895,7 +2898,10 @@ function evaluateCondition(condition) {
 }
 
 // src/ui/app.ts
-import { BoxRenderable, createCliRenderer } from "@opentui/core";
+import { BoxRenderable as BoxRenderable3, createCliRenderer } from "@opentui/core";
+
+// src/ui/help-overlay.ts
+import { BoxRenderable, TextRenderable } from "@opentui/core";
 
 // src/ui/keybindings.ts
 var SHORTCUTS = {
@@ -2910,20 +2916,105 @@ var SHORTCUTS = {
   scrollToBottom: { key: "g", label: "Shift+G", description: "bottom", shift: true },
   openLogs: { key: "o", label: "O", description: "open logs" }
 };
-var STATUS_HINTS = [
-  ["\u2190\u2192/1-9", "tabs"],
+function toHintPair(hint) {
+  return Array.isArray(hint) ? hint : [hint.label, hint.description];
+}
+var STATUS_HINTS_COMPACT = [
+  ["\u2190\u2192", "tabs"],
+  SHORTCUTS.search,
+  SHORTCUTS.copy,
+  ["Enter", "input"],
+  ["H", "help"]
+];
+var STATUS_HINTS_FULL = [
+  ["\u2190\u2192/1-9", "switch tabs"],
+  ["Enter", "input mode"],
+  SHORTCUTS.search,
+  SHORTCUTS.restart,
+  SHORTCUTS.restartAll,
+  SHORTCUTS.stopStart,
+  SHORTCUTS.copy,
+  SHORTCUTS.clear,
+  SHORTCUTS.timestamps,
+  ["\u2191\u2193", "scroll line"],
+  ["Shift+\u2191\u2193", "top/bottom"],
   ["G/Shift+G", "top/bottom"],
-  [SHORTCUTS.restart.label, SHORTCUTS.restart.description],
-  [SHORTCUTS.stopStart.label, SHORTCUTS.stopStart.description],
-  [SHORTCUTS.search.label, SHORTCUTS.search.description],
-  [SHORTCUTS.copy.label, SHORTCUTS.copy.description],
-  [SHORTCUTS.clear.label, SHORTCUTS.clear.description],
-  [SHORTCUTS.timestamps.label, SHORTCUTS.timestamps.description],
-  [SHORTCUTS.openLogs.label, SHORTCUTS.openLogs.description],
+  ["PgUp/PgDn", "scroll page"],
+  SHORTCUTS.openLogs,
   ["Ctrl+Click", "open link"],
   ["Ctrl+C", "quit"]
 ];
-var STATUS_BAR_TEXT = STATUS_HINTS.map(([l, d]) => `${l}: ${d}`).join("  ");
+var STATUS_BAR_TEXT = STATUS_HINTS_COMPACT.map((h) => {
+  const [l, d] = toHintPair(h);
+  return `${l}: ${d}`;
+}).join("  ");
+
+// src/ui/help-overlay.ts
+class HelpOverlay {
+  renderable;
+  textRenderable;
+  constructor(renderer) {
+    this.renderable = new BoxRenderable(renderer, {
+      id: "help-overlay",
+      position: "absolute",
+      width: "100%",
+      height: "100%",
+      zIndex: 100,
+      visible: false,
+      justifyContent: "center",
+      alignItems: "center"
+    });
+    const backdrop = new BoxRenderable(renderer, {
+      id: "help-backdrop",
+      position: "absolute",
+      width: "100%",
+      height: "100%",
+      backgroundColor: "#000000",
+      opacity: 0.7
+    });
+    const box = new BoxRenderable(renderer, {
+      id: "help-box",
+      flexDirection: "column",
+      padding: 1,
+      paddingX: 5,
+      backgroundColor: "#1a1a2e",
+      border: true,
+      borderColor: "#444",
+      zIndex: 101
+    });
+    const lines = [
+      "Keyboard Shortcuts",
+      "",
+      ...STATUS_HINTS_FULL.map((h) => {
+        const [label, desc] = toHintPair(h);
+        return `  ${label.padEnd(14)} ${desc}`;
+      }),
+      "",
+      "Press H or Esc to close"
+    ];
+    this.textRenderable = new TextRenderable(renderer, {
+      id: "help-text",
+      content: lines.join(`
+`),
+      fg: "#cccccc"
+    });
+    box.add(this.textRenderable);
+    this.renderable.add(backdrop);
+    this.renderable.add(box);
+  }
+  get isVisible() {
+    return this.renderable.visible;
+  }
+  toggle() {
+    this.renderable.visible = !this.renderable.visible;
+  }
+  hide() {
+    this.renderable.visible = false;
+  }
+  show() {
+    this.renderable.visible = true;
+  }
+}
 
 // src/ui/pane.ts
 import {
@@ -3811,13 +3902,22 @@ class SearchController {
 }
 
 // src/ui/status-bar.ts
-import { cyan, red, reverse, StyledText as StyledText2, TextRenderable, yellow } from "@opentui/core";
+import {
+  BoxRenderable as BoxRenderable2,
+  cyan,
+  red,
+  reverse,
+  StyledText as StyledText2,
+  TextRenderable as TextRenderable2,
+  yellow
+} from "@opentui/core";
 function plain(text) {
   return { __isChunk: true, text };
 }
 
 class StatusBar {
   renderable;
+  text;
   _searchMode = false;
   _searchQuery = "";
   _searchMatchCount = 0;
@@ -3825,16 +3925,23 @@ class StatusBar {
   _crossProcessInfo;
   _tempMessage = null;
   _tempTimer = null;
+  _inputMode = false;
   constructor(renderer) {
-    this.renderable = new TextRenderable(renderer, {
+    this.renderable = new BoxRenderable2(renderer, {
       id: "status-bar",
       width: "100%",
+      backgroundColor: "#1a1a1a",
+      paddingX: 1,
+      minHeight: 1
+    });
+    this.text = new TextRenderable2(renderer, {
+      id: "status-bar-text",
+      width: "100%",
       wrapMode: "word",
-      content: this.buildContent(),
-      bg: "#1a1a1a",
-      paddingX: 1
+      content: this.buildContent()
     });
-    this.renderable.selectable = false;
+    this.text.selectable = false;
+    this.renderable.add(this.text);
   }
   setSearchMode(active, query = "", matchCount = 0, currentIndex = -1, crossProcessInfo) {
     this._searchMode = active;
@@ -3842,19 +3949,23 @@ class StatusBar {
     this._searchMatchCount = matchCount;
     this._searchCurrentIndex = currentIndex;
     this._crossProcessInfo = crossProcessInfo;
-    this.renderable.content = this.buildContent();
+    this.text.content = this.buildContent();
   }
   showTemporaryMessage(message, duration = 2000) {
     if (this._tempTimer)
       clearTimeout(this._tempTimer);
     this._tempMessage = message;
-    this.renderable.content = this.buildContent();
+    this.text.content = this.buildContent();
     this._tempTimer = setTimeout(() => {
       this._tempMessage = null;
       this._tempTimer = null;
-      this.renderable.content = this.buildContent();
+      this.text.content = this.buildContent();
     }, duration);
   }
+  setInputMode(active) {
+    this._inputMode = active;
+    this.text.content = this.buildContent();
+  }
   buildContent() {
     if (this._tempMessage) {
       return new StyledText2([cyan(this._tempMessage)]);
@@ -3862,6 +3973,9 @@ class StatusBar {
     if (this._searchMode) {
       return this.buildSearchContent();
     }
+    if (this._inputMode) {
+      return new StyledText2([yellow("INPUT"), plain("  Type to send input to process.  "), plain("Esc: exit")]);
+    }
     return new StyledText2([plain(STATUS_BAR_TEXT)]);
   }
   buildSearchContent() {
@@ -4150,8 +4264,10 @@ class App {
   panes = new Map;
   tabBar;
   statusBar;
+  helpOverlay;
   search;
   activePane = null;
+  inputMode = false;
   destroyed = false;
   names;
   termCols = 80;
@@ -4180,7 +4296,7 @@ class App {
     this.termCols = Math.max(40, width - this.sidebarWidth - 2);
     this.termRows = Math.max(5, height - 2);
     const { termCols, termRows } = this;
-    const layout = new BoxRenderable(this.renderer, {
+    const layout = new BoxRenderable3(this.renderer, {
       id: "root",
       flexDirection: "column",
       width: "100%",
@@ -4189,14 +4305,14 @@ class App {
     });
     const processHexColors = buildProcessHexColorMap(this.names, this.config);
     this.tabBar = new TabBar(this.renderer, this.names, processHexColors);
-    const contentRow = new BoxRenderable(this.renderer, {
+    const contentRow = new BoxRenderable3(this.renderer, {
       id: "content-row",
       flexDirection: "row",
       flexGrow: 1,
       width: "100%",
       border: false
     });
-    const sidebar = new BoxRenderable(this.renderer, {
+    const sidebar = new BoxRenderable3(this.renderer, {
       id: "sidebar",
       width: this.sidebarWidth,
       height: "100%",
@@ -4204,12 +4320,13 @@ class App {
       borderColor: "#444"
     });
     sidebar.add(this.tabBar.renderable);
-    const paneContainer = new BoxRenderable(this.renderer, {
+    const paneContainer = new BoxRenderable3(this.renderer, {
       id: "pane-container",
       flexGrow: 1,
       border: false
     });
     this.statusBar = new StatusBar(this.renderer);
+    this.helpOverlay = new HelpOverlay(this.renderer);
     this.search = new SearchController({
       logWriter: this.logWriter,
       statusBar: this.statusBar,
@@ -4244,6 +4361,7 @@ class App {
     layout.add(contentRow);
     layout.add(this.statusBar.renderable);
     this.renderer.root.add(layout);
+    this.renderer.root.add(this.helpOverlay.renderable);
     this.tabBar.onSelect((_index, name) => this.switchPane(name));
     this.tabBar.onSelectionChanged((_index, name) => this.switchPane(name));
     this.manager.on((event) => {
@@ -4280,6 +4398,14 @@ class App {
     this.renderer.keyInput.on("keypress", (key) => {
       log(key);
       if (key.ctrl && key.name === "c") {
+        if (this.helpOverlay.isVisible) {
+          this.helpOverlay.hide();
+          return;
+        }
+        if (this.inputMode) {
+          this.exitInputMode();
+          return;
+        }
         if (this.search.isActive) {
           this.search.exit();
           return;
@@ -4289,15 +4415,39 @@ class App {
         });
         return;
       }
+      if (this.helpOverlay.isVisible) {
+        if (key.name === "escape" || key.sequence === "?" || key.name === "h") {
+          this.helpOverlay.hide();
+        }
+        return;
+      }
       if (this.search.isActive) {
         this.search.handleInput(key);
         return;
       }
+      if (this.inputMode && this.activePane) {
+        if (key.name === "escape") {
+          this.exitInputMode();
+          return;
+        }
+        if (key.sequence) {
+          this.manager.write(this.activePane, key.sequence);
+        }
+        return;
+      }
       if (!this.activePane)
         return;
       const isInteractive = this.config.processes[this.activePane]?.interactive === true;
       if (!isInteractive) {
         const name = key.name.toLowerCase();
+        if (key.sequence === "?" || name === "h") {
+          this.helpOverlay.toggle();
+          return;
+        }
+        if (name === "return") {
+          this.enterInputMode();
+          return;
+        }
         if (key.shift && name === SHORTCUTS.scrollToBottom.key) {
           this.panes.get(this.activePane)?.scrollToBottom();
           return;
@@ -4366,6 +4516,15 @@ class App {
           this.switchPane(this.tabBar.getNameAtIndex(next));
           return;
         }
+        if (name === "up" || name === "down") {
+          const pane = this.panes.get(this.activePane);
+          if (key.shift) {
+            name === "up" ? pane?.scrollToTop() : pane?.scrollToBottom();
+          } else {
+            pane?.scrollBy(name === "up" ? -1 : 1);
+          }
+          return;
+        }
         if (name === "pageup" || name === "pagedown") {
           const pane = this.panes.get(this.activePane);
           const delta = this.termRows - 2;
@@ -4392,9 +4551,33 @@ class App {
     }
     await this.manager.startAll(termCols, termRows);
   }
+  enterInputMode() {
+    this.inputMode = true;
+    this.statusBar.setInputMode(true);
+    if (this.activePane) {
+      const pane = this.panes.get(this.activePane);
+      if (pane)
+        pane.terminal.showCursor = true;
+    }
+  }
+  exitInputMode() {
+    this.inputMode = false;
+    this.statusBar.setInputMode(false);
+    if (this.activePane) {
+      const isInteractive = this.config.processes[this.activePane]?.interactive === true;
+      if (!isInteractive) {
+        const pane = this.panes.get(this.activePane);
+        if (pane)
+          pane.terminal.showCursor = false;
+      }
+    }
+  }
   switchPane(name) {
     if (this.activePane === name)
       return;
+    if (this.inputMode) {
+      this.exitInputMode();
+    }
     if (this.search.isActive && !this.search.isAllMode) {
       this.search.exit();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numux",
-  "version": "2.13.1",
+  "version": "2.14.0",
   "description": "Terminal multiplexer with dependency orchestration",
   "type": "module",
   "license": "MIT",