numux 2.13.0 → 2.14.0

package/README.md

@@ -226,7 +226,7 @@ export default defineConfig({
 | `--kill-others-on-fail` | Kill all processes when any exits with non-zero code |
 | `--max-restarts` `<n>` | Max auto-restarts for crashed processes |
 | `--no-watch` | Disable file watching even if config has watch patterns |
-| `-t,` `--timestamps` `[<format>]` | Add timestamps to output (default HH:mm:ss, or pass a format string) |
+| `-t,` `--timestamps` `[<format>]` | Add timestamps to output (default HH:mm:ss.SSS, or pass a format string) |
 | `--log-dir` `<path>` | Write per-process logs to directory |
 | `--debug` | Enable debug logging to .numux/debug.log |
 | `-h,` `--help` | Show this help |
@@ -277,7 +277,7 @@ Top-level options apply to all processes (process-level settings override):
 | `watch` | `string \| string[]` | Global watch patterns, inherited by processes without their own watch |
 | `sort` | `'config' \| 'alphabetical' \| 'topological'` | Tab display order. `'config'` preserves definition order (package.json script order for wildcards), `'alphabetical'` sorts by process name, `'topological'` sorts by dependency tiers. |
 | `prefix` | `boolean` | Use prefixed output mode instead of TUI (for CI/scripts) |
-| `timestamps` | `boolean \| string` | Add timestamps to output lines. `true` uses default `HH:mm:ss` format, or pass a format string (e.g. `"HH:mm:ss.SSS"`) |
+| `timestamps` | `boolean \| string` | Add timestamps to output lines. `true` uses default `HH:mm:ss.SSS` format, or pass a format string (e.g. `"HH:mm:ss"`) |
 | `killOthers` | `boolean` | Kill all processes when any one exits (regardless of exit code) |
 | `killOthersOnFail` | `boolean` | Kill all processes when any one exits with a non-zero exit code |
 | `noWatch` | `boolean` | Disable file watching even if processes have watch patterns |
@@ -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.0" "numux manual"
+.TH "NUMUX" "1" "April 2026" "2.14.0" "numux manual"
 .SH "NAME"
 \fBnumux\fR
 .P
@@ -339,7 +339,7 @@ _
 T{
 \fB\-t,\fP \fB\-\-timestamps\fP \fB[<format>]\fP
 T}|T{
-Add timestamps to output (default HH:mm:ss, or pass a format string)
+Add timestamps to output (default HH:mm:ss\.SSS, or pass a format string)
 T}
 _
 T{
@@ -502,7 +502,7 @@ T{
 T}|T{
 \fBboolean | string\fP
 T}|T{
-Add timestamps to output lines\. \fBtrue\fP uses default \fBHH:mm:ss\fP format, or pass a format string (e\.g\. \fB&quot;HH:mm:ss\.SSS&quot;\fP)
+Add timestamps to output lines\. \fBtrue\fP uses default \fBHH:mm:ss\.SSS\fP format, or pass a format string (e\.g\. \fB&quot;HH:mm:ss&quot;\fP)
 T}
 _
 T{
@@ -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

@@ -244,7 +244,7 @@ export default defineConfig({
 | \`--kill-others-on-fail\` | Kill all processes when any exits with non-zero code |
 | \`--max-restarts\` \`<n>\` | Max auto-restarts for crashed processes |
 | \`--no-watch\` | Disable file watching even if config has watch patterns |
-| \`-t,\` \`--timestamps\` \`[<format>]\` | Add timestamps to output (default HH:mm:ss, or pass a format string) |
+| \`-t,\` \`--timestamps\` \`[<format>]\` | Add timestamps to output (default HH:mm:ss.SSS, or pass a format string) |
 | \`--log-dir\` \`<path>\` | Write per-process logs to directory |
 | \`--debug\` | Enable debug logging to .numux/debug.log |
 | \`-h,\` \`--help\` | Show this help |
@@ -283,7 +283,7 @@ numux logs api | tail -f           # Follow process log output
 | \`watch\` | \`string \\| string[]\` | Global watch patterns, inherited by processes without their own watch |
 | \`sort\` | \`'config' \\| 'alphabetical' \\| 'topological'\` | Tab display order. \`'config'\` preserves definition order (package.json script order for wildcards), \`'alphabetical'\` sorts by process name, \`'topological'\` sorts by dependency tiers. |
 | \`prefix\` | \`boolean\` | Use prefixed output mode instead of TUI (for CI/scripts) |
-| \`timestamps\` | \`boolean \\| string\` | Add timestamps to output lines. \`true\` uses default \`HH:mm:ss\` format, or pass a format string (e.g. \`"HH:mm:ss.SSS"\`) |
+| \`timestamps\` | \`boolean \\| string\` | Add timestamps to output lines. \`true\` uses default \`HH:mm:ss.SSS\` format, or pass a format string (e.g. \`"HH:mm:ss"\`) |
 | \`killOthers\` | \`boolean\` | Kill all processes when any one exits (regardless of exit code) |
 | \`killOthersOnFail\` | \`boolean\` | Kill all processes when any one exits with a non-zero exit code |
 | \`noWatch\` | \`boolean\` | Disable file watching even if processes have watch patterns |
@@ -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.0",
+    version: "2.14.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -857,7 +862,7 @@ var FLAGS = [
     long: "--timestamps",
     short: "-t",
     key: "timestamps",
-    description: "Add timestamps to output (default HH:mm:ss, or pass a format string)",
+    description: "Add timestamps to output (default HH:mm:ss.SSS, or pass a format string)",
     valueName: "<format>",
     completionHint: "none"
   },
@@ -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 {
@@ -3340,7 +3431,7 @@ Object.defineProperty(GhosttyTerminalRenderable.prototype, "lineInfo", {
 });
 
 // src/utils/timestamp.ts
-var DEFAULT_TIMESTAMP_FORMAT = "HH:mm:ss";
+var DEFAULT_TIMESTAMP_FORMAT = "HH:mm:ss.SSS";
 function formatTimestamp(date, format) {
   const hours24 = date.getHours();
   const hours12 = hours24 % 12 || 12;
@@ -3601,18 +3692,16 @@ class Pane {
   get timestampsEnabled() {
     return this._timestampFormat !== null;
   }
+  getTimestampSigns() {
+    return this.timestampGutter?.getLineSigns() ?? null;
+  }
   updateTimestampSigns() {
     if (!(this.timestampGutter && this._timestampFormat))
       return;
     const fmt = this._timestampFormat;
     const signs = new Map;
-    let prevFormatted = "";
     for (let i = 0;i < this.lineTimestamps.length; i++) {
-      const formatted = formatTimestamp(new Date(this.lineTimestamps[i]), fmt);
-      if (formatted !== prevFormatted) {
-        signs.set(i, { before: formatted });
-        prevFormatted = formatted;
-      }
+      signs.set(i, { before: formatTimestamp(new Date(this.lineTimestamps[i]), fmt) });
     }
     this.timestampGutter.setLineSigns(signs);
   }
@@ -3813,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;
@@ -3827,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;
@@ -3844,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)]);
@@ -3864,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() {
@@ -4152,8 +4264,10 @@ class App {
   panes = new Map;
   tabBar;
   statusBar;
+  helpOverlay;
   search;
   activePane = null;
+  inputMode = false;
   destroyed = false;
   names;
   termCols = 80;
@@ -4182,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%",
@@ -4191,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%",
@@ -4206,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,
@@ -4246,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) => {
@@ -4282,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;
@@ -4291,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;
@@ -4368,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;
@@ -4394,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/dist/types.d.ts

@@ -102,7 +102,7 @@ export interface NumuxConfig<K extends string = string> {
      * @default false
      */
     prefix?: boolean;
-    /** Add timestamps to output lines. `true` uses default `HH:mm:ss` format, or pass a format string (e.g. `"HH:mm:ss.SSS"`) */
+    /** Add timestamps to output lines. `true` uses default `HH:mm:ss.SSS` format, or pass a format string (e.g. `"HH:mm:ss"`) */
     timestamps?: boolean | string;
     /**
      * Kill all processes when any one exits (regardless of exit code)

package/package.json

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