numux 1.7.0 → 1.9.0

package/README.md

@@ -265,22 +265,7 @@ Persistent processes that crash are auto-restarted with exponential backoff (1s
 
 ## Keybindings
 
-| Key | Action |
-|-----|--------|
-| `Ctrl+C` | Quit (graceful shutdown) |
-| `R` | Restart active process |
-| `Shift+R` | Restart all processes |
-| `S` | Stop/start active process |
-| `L` | Clear active pane output |
-| `F` | Search in active pane output |
-| `1`–`9` | Jump to tab |
-| `Left/Right` | Cycle tabs |
-| `PageUp/PageDown` | Scroll output by page |
-| `Home/End` | Scroll to top/bottom |
-
-While searching: type to filter, `Enter`/`Shift+Enter` to navigate matches, `Escape` to close.
-
-Panes are readonly by default — keyboard input is not forwarded to processes. Set `interactive: true` on processes that need stdin (REPLs, shells, etc.).
+Keybindings are shown in the status bar at the bottom of the app. Panes are readonly by default — keyboard input is not forwarded to processes. Set `interactive: true` on processes that need stdin (REPLs, shells, etc.).
 
 ## Tab icons
 

package/dist/numux.js

@@ -22,7 +22,7 @@ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports,
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "1.7.0",
+    version: "1.9.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -92,6 +92,7 @@ function parseArgs(argv) {
     timestamps: false,
     noRestart: false,
     noWatch: false,
+    autoColors: false,
     configPath: undefined,
     commands: [],
     named: []
@@ -123,6 +124,8 @@ function parseArgs(argv) {
       result.noRestart = true;
     } else if (arg === "--no-watch") {
       result.noWatch = true;
+    } else if (arg === "--colors") {
+      result.autoColors = true;
     } else if (arg === "--config") {
       result.configPath = consumeValue(arg);
     } else if (arg === "-c" || arg === "--color") {
@@ -279,7 +282,7 @@ _numux() {
   esac
 
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-h --help -v --version -c --color --config -n --name -p --prefix --only --exclude --kill-others --no-restart --no-watch -t --timestamps --log-dir --debug" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-h --help -v --version -c --color --colors --config -n --name -p --prefix --only --exclude --kill-others --no-restart --no-watch -t --timestamps --log-dir --debug" -- "$cur") )
   else
     local subcmds="init validate exec completions"
     COMPREPLY=( $(compgen -W "$subcmds" -- "$cur") )
@@ -304,6 +307,7 @@ _numux() {
     '(-h --help)'{-h,--help}'[Show help]' \\
     '(-v --version)'{-v,--version}'[Show version]' \\
     '(-c --color)'{-c,--color}'[Comma-separated colors for processes]' \\
+    '--colors[Auto-assign colors based on process name]' \\
     '--config[Config file path]:file:_files' \\
     '(-n --name)'{-n,--name}'[Named process (name=command)]:named process' \\
     '(-p --prefix)'{-p,--prefix}'[Prefixed output mode]' \\
@@ -346,6 +350,7 @@ complete -c numux -n '__fish_seen_subcommand_from completions' -a 'bash zsh fish
 complete -c numux -s h -l help -d 'Show help'
 complete -c numux -s v -l version -d 'Show version'
 complete -c numux -s c -l color -r -d 'Comma-separated colors for processes'
+complete -c numux -l colors -d 'Auto-assign colors based on process name'
 complete -c numux -l config -rF -d 'Config file path'
 complete -c numux -s n -l name -r -d 'Named process (name=command)'
 complete -c numux -s p -l prefix -d 'Prefixed output mode'
@@ -651,6 +656,13 @@ var DEFAULT_ANSI_COLORS = [
   "\x1B[95m"
 ];
 var DEFAULT_HEX_COLORS = ["#00cccc", "#cccc00", "#cc00cc", "#0000cc", "#00cc00", "#ff5555", "#ffff55", "#ff55ff"];
+function colorFromName(name) {
+  let hash = 0;
+  for (let i = 0;i < name.length; i++) {
+    hash = (hash << 5) - hash + name.charCodeAt(i) | 0;
+  }
+  return DEFAULT_HEX_COLORS[Math.abs(hash) % DEFAULT_HEX_COLORS.length];
+}
 function resolveColor(color) {
   if (typeof color === "string")
     return color;
@@ -797,7 +809,8 @@ function validateConfig(raw, warnings) {
       stopSignal: validateStopSignal(p.stopSignal),
       color: typeof p.color === "string" ? p.color : Array.isArray(p.color) ? p.color : undefined,
       watch: validateStringOrStringArray(p.watch),
-      interactive: typeof p.interactive === "boolean" ? p.interactive : false
+      interactive: typeof p.interactive === "boolean" ? p.interactive : false,
+      errorMatcher: validateErrorMatcher(name, p.errorMatcher)
     };
   }
   return { processes: validated };
@@ -810,6 +823,22 @@ function validateStringOrStringArray(value) {
   return;
 }
 var validateEnvFile = validateStringOrStringArray;
+function validateErrorMatcher(name, value) {
+  if (value === true)
+    return true;
+  if (typeof value === "string" && value.trim()) {
+    try {
+      new RegExp(value);
+    } catch (err) {
+      throw new Error(`Process "${name}".errorMatcher is not a valid regex: "${value}"`, { cause: err });
+    }
+    return value;
+  }
+  if (value !== undefined && value !== false) {
+    throw new Error(`Process "${name}".errorMatcher must be true or a regex string`);
+  }
+  return;
+}
 var VALID_STOP_SIGNALS = new Set(["SIGTERM", "SIGINT", "SIGHUP"]);
 function validateStopSignal(value) {
   if (typeof value === "string" && VALID_STOP_SIGNALS.has(value)) {
@@ -917,8 +946,49 @@ function loadEnvFiles(envFile, cwd) {
   return merged;
 }
 
-// src/process/ready.ts
+// src/process/error.ts
 var BUFFER_CAP = 65536;
+var SGR_RE = /\x1b\[([0-9;]*)m/g;
+function hasAnsiRed(text) {
+  SGR_RE.lastIndex = 0;
+  for (let match = SGR_RE.exec(text);match !== null; match = SGR_RE.exec(text)) {
+    const params = match[1].split(";");
+    if (params.includes("31") || params.includes("91"))
+      return true;
+  }
+  return false;
+}
+function createErrorChecker(config) {
+  const matcher = config.errorMatcher;
+  if (!matcher)
+    return null;
+  const pattern = typeof matcher === "string" ? new RegExp(matcher) : null;
+  let buffer = "";
+  let triggered = false;
+  return {
+    feedOutput(data) {
+      if (triggered)
+        return false;
+      buffer += data;
+      if (buffer.length > BUFFER_CAP) {
+        buffer = buffer.slice(-BUFFER_CAP);
+      }
+      if (pattern) {
+        if (pattern.test(stripAnsi(buffer))) {
+          triggered = true;
+          return true;
+        }
+      } else if (hasAnsiRed(buffer)) {
+        triggered = true;
+        return true;
+      }
+      return false;
+    }
+  };
+}
+
+// src/process/ready.ts
+var BUFFER_CAP2 = 65536;
 function createReadinessChecker(config) {
   const pattern = config.readyPattern ? new RegExp(config.readyPattern) : null;
   const persistent = config.persistent !== false;
@@ -928,8 +998,8 @@ function createReadinessChecker(config) {
       if (!(persistent && pattern))
         return false;
       outputBuffer += data;
-      if (outputBuffer.length > BUFFER_CAP) {
-        outputBuffer = outputBuffer.slice(-BUFFER_CAP);
+      if (outputBuffer.length > BUFFER_CAP2) {
+        outputBuffer = outputBuffer.slice(-BUFFER_CAP2);
       }
       return pattern.test(outputBuffer);
     },
@@ -949,9 +1019,11 @@ class ProcessRunner {
   handler;
   proc = null;
   readiness;
+  errorChecker;
   _ready = false;
   stopping = false;
   decoder = new TextDecoder;
+  errorDecoder = new TextDecoder;
   generation = 0;
   readyTimer = null;
   restarting = false;
@@ -961,6 +1033,7 @@ class ProcessRunner {
     this.config = config;
     this.handler = handler;
     this.readiness = createReadinessChecker(config);
+    this.errorChecker = createErrorChecker(config);
   }
   get isReady() {
     return this._ready;
@@ -995,6 +1068,7 @@ class ProcessRunner {
               return;
             this.handler.onOutput(data);
             this.checkReadiness(data);
+            this.checkError(data);
           }
         }
       });
@@ -1050,6 +1124,14 @@ class ProcessRunner {
       this.markReady();
     }
   }
+  checkError(data) {
+    if (!this.errorChecker)
+      return;
+    const text = this.errorDecoder.decode(data, { stream: true });
+    if (this.errorChecker.feedOutput(text)) {
+      this.handler.onError();
+    }
+  }
   startReadyTimeout(gen) {
     const timeout = this.config.readyTimeout;
     if (!(timeout && this.config.readyPattern) || this.config.persistent === false)
@@ -1108,6 +1190,7 @@ class ProcessRunner {
     this.restarting = false;
     this.readyTimedOut = false;
     this.readiness = createReadinessChecker(this.config);
+    this.errorChecker = createErrorChecker(this.config);
     this.start(cols, rows);
   }
   async stop(timeoutMs = 5000) {
@@ -1277,7 +1360,8 @@ class ProcessManager {
           readyResolved = true;
           onInitialReady();
         }
-      }
+      },
+      onError: () => this.emit({ type: "error", name })
     });
     this.runners.set(name, runner);
   }
@@ -1465,6 +1549,26 @@ function evaluateCondition(condition) {
 // src/ui/app.ts
 import { BoxRenderable, createCliRenderer } from "@opentui/core";
 
+// src/ui/keybindings.ts
+var SHORTCUTS = {
+  restartAll: { key: "r", label: "Shift+R", description: "restart all", shift: true },
+  copy: { key: "y", label: "Y", description: "copy" },
+  search: { key: "f", label: "F", description: "search" },
+  restart: { key: "r", label: "R", description: "restart" },
+  stopStart: { key: "s", label: "S", description: "stop/start" },
+  clear: { key: "l", label: "L", description: "clear" }
+};
+var STATUS_HINTS = [
+  ["\u2190\u2192/1-9", "tabs"],
+  [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],
+  ["Ctrl+C", "quit"]
+];
+var STATUS_BAR_TEXT = STATUS_HINTS.map(([l, d]) => `${l}: ${d}`).join("  ");
+
 // src/ui/pane.ts
 import { ScrollBoxRenderable } from "@opentui/core";
 import { GhosttyTerminalRenderable } from "ghostty-opentui/terminal-buffer";
@@ -1474,6 +1578,7 @@ class Pane {
   terminal;
   decoder = new TextDecoder;
   _onScroll = null;
+  _onCopy = null;
   constructor(renderer, name, cols, rows, interactive = false) {
     this.scrollBox = new ScrollBoxRenderable(renderer, {
       id: `pane-${name}`,
@@ -1492,6 +1597,18 @@ class Pane {
       showCursor: interactive,
       trimEnd: true
     });
+    const origOnSelectionChanged = this.terminal.onSelectionChanged.bind(this.terminal);
+    this.terminal.onSelectionChanged = (selection) => {
+      const result = origOnSelectionChanged(selection);
+      if (selection?.isActive && !selection.isDragging) {
+        const text = selection.getSelectedText();
+        if (text) {
+          renderer.copyToClipboardOSC52(text);
+          this._onCopy?.(text);
+        }
+      }
+      return result;
+    };
     this.scrollBox.add(this.terminal);
   }
   feed(data) {
@@ -1520,6 +1637,9 @@ class Pane {
   onScroll(handler) {
     this._onScroll = handler;
   }
+  onCopy(handler) {
+    this._onCopy = handler;
+  }
   show() {
     this.scrollBox.visible = true;
   }
@@ -1583,6 +1703,8 @@ class StatusBar {
   _searchQuery = "";
   _searchMatchCount = 0;
   _searchCurrentIndex = -1;
+  _tempMessage = null;
+  _tempTimer = null;
   constructor(renderer) {
     this.renderable = new TextRenderable(renderer, {
       id: "status-bar",
@@ -1600,13 +1722,25 @@ class StatusBar {
     this._searchCurrentIndex = currentIndex;
     this.renderable.content = this.buildContent();
   }
+  showTemporaryMessage(message, duration = 2000) {
+    if (this._tempTimer)
+      clearTimeout(this._tempTimer);
+    this._tempMessage = message;
+    this.renderable.content = this.buildContent();
+    this._tempTimer = setTimeout(() => {
+      this._tempMessage = null;
+      this._tempTimer = null;
+      this.renderable.content = this.buildContent();
+    }, duration);
+  }
   buildContent() {
+    if (this._tempMessage) {
+      return new StyledText([cyan(this._tempMessage)]);
+    }
     if (this._searchMode) {
       return this.buildSearchContent();
     }
-    return new StyledText([
-      plain("\u2190\u2192/1-9: tabs  R: restart  S: stop/start  F: search  L: clear  Ctrl+C: quit")
-    ]);
+    return new StyledText([plain(STATUS_BAR_TEXT)]);
   }
   buildSearchContent() {
     const chunks = [];
@@ -1684,20 +1818,24 @@ class ColoredSelectRenderable extends SelectRenderable {
     const scrollOffset = this.scrollOffset;
     const maxVisibleItems = this.maxVisibleItems;
     const linesPerItem = this.linesPerItem;
+    const selectedIndex = this.getSelectedIndex();
     const options = this.options;
     const visibleCount = Math.min(maxVisibleItems, options.length - scrollOffset);
+    const baseTextColor = this._focused ? this._focusedTextColor : this._textColor;
+    const selectedTextColor = this._selectedTextColor;
     for (let i = 0;i < visibleCount; i++) {
       const actualIndex = scrollOffset + i;
-      const colors = this._optionColors[actualIndex];
-      if (!colors)
-        continue;
       const itemY = i * linesPerItem;
       const optName = options[actualIndex].name;
-      if (colors.icon) {
-        fb.drawText(optName.charAt(0), 3, itemY, colors.icon);
+      const isSelected = actualIndex === selectedIndex;
+      const defaultColor = isSelected ? selectedTextColor : baseTextColor;
+      const colors = this._optionColors[actualIndex];
+      fb.drawText(`${optName}  `, 1, itemY, defaultColor);
+      if (colors?.icon) {
+        fb.drawText(optName.charAt(0), 1, itemY, colors.icon);
       }
-      if (colors.name) {
-        fb.drawText(optName.slice(2), 5, itemY, colors.name);
+      if (colors?.name) {
+        fb.drawText(optName.slice(2), 3, itemY, colors.name);
       }
     }
   }
@@ -1711,6 +1849,7 @@ class TabBar {
   baseDescriptions;
   processColors;
   inputWaiting = new Set;
+  erroredProcesses = new Set;
   constructor(renderer, names, colors) {
     this.originalNames = names;
     this.names = [...names];
@@ -1749,6 +1888,9 @@ class TabBar {
     if (TERMINAL_STATUSES.has(status) || status === "stopping") {
       this.inputWaiting.delete(name);
     }
+    if (status === "starting") {
+      this.erroredProcesses.delete(name);
+    }
     this.refreshOptions();
   }
   setInputWaiting(name, waiting) {
@@ -1758,6 +1900,13 @@ class TabBar {
       this.inputWaiting.delete(name);
     this.refreshOptions();
   }
+  setError(name, hasError) {
+    if (hasError)
+      this.erroredProcesses.add(name);
+    else
+      this.erroredProcesses.delete(name);
+    this.refreshOptions();
+  }
   getNameAtIndex(index) {
     return this.names[index];
   }
@@ -1786,13 +1935,16 @@ class TabBar {
   getDescription(name) {
     if (this.inputWaiting.has(name))
       return "awaiting input";
+    if (this.erroredProcesses.has(name))
+      return "error detected";
     return this.baseDescriptions.get(name) ?? "pending";
   }
   updateOptionColors() {
     const colors = this.names.map((name) => {
       const status = this.statuses.get(name);
       const waiting = this.inputWaiting.has(name);
-      const statusHex = waiting ? "#ffaa00" : STATUS_ICON_HEX[status];
+      const errored = this.erroredProcesses.has(name);
+      const statusHex = waiting ? "#ffaa00" : errored ? "#ff5555" : STATUS_ICON_HEX[status];
       const processHex = this.processColors.get(name);
       return {
         icon: parseColor(statusHex ?? processHex ?? "#888888"),
@@ -1895,6 +2047,7 @@ class App {
     for (const name of this.names) {
       const interactive = this.config.processes[name].interactive === true;
       const pane = new Pane(this.renderer, name, termCols, termRows, interactive);
+      pane.onCopy(() => this.statusBar.showTemporaryMessage("Copied!"));
       this.panes.set(name, pane);
       paneContainer.add(pane.scrollBox);
     }
@@ -1914,6 +2067,8 @@ class App {
         if (this.config.processes[event.name]?.interactive) {
           this.checkInputWaiting(event.name, event.data);
         }
+      } else if (event.type === "error") {
+        this.tabBar.setError(event.name, true);
       } else if (event.type === "status") {
         const state = this.manager.getState(event.name);
         this.tabBar.updateStatus(event.name, event.status, state?.exitCode, state?.restartCount);
@@ -1956,19 +2111,23 @@ class App {
       const isInteractive = this.config.processes[this.activePane]?.interactive === true;
       if (!isInteractive) {
         const name = key.name.toLowerCase();
-        if (key.shift && name === "r") {
+        if (key.shift && name === SHORTCUTS.restartAll.key) {
           this.manager.restartAll(this.termCols, this.termRows);
           return;
         }
-        if (name === "f") {
+        if (name === SHORTCUTS.copy.key) {
+          this.copySelection();
+          return;
+        }
+        if (name === SHORTCUTS.search.key) {
           this.enterSearch();
           return;
         }
-        if (name === "r") {
+        if (name === SHORTCUTS.restart.key) {
           this.manager.restart(this.activePane, this.termCols, this.termRows);
           return;
         }
-        if (name === "s") {
+        if (name === SHORTCUTS.stopStart.key) {
           const state = this.manager.getState(this.activePane);
           if (state?.status === "stopped" || state?.status === "finished" || state?.status === "failed") {
             this.manager.start(this.activePane, this.termCols, this.termRows);
@@ -1977,7 +2136,7 @@ class App {
           }
           return;
         }
-        if (name === "l") {
+        if (name === SHORTCUTS.clear.key) {
           this.panes.get(this.activePane)?.clear();
           return;
         }
@@ -2065,6 +2224,18 @@ class App {
       this.tabBar.setInputWaiting(name, false);
     }
   }
+  copySelection() {
+    const selection = this.renderer.getSelection();
+    if (!selection?.isActive)
+      return false;
+    const text = selection.getSelectedText();
+    if (!text)
+      return false;
+    this.renderer.copyToClipboardOSC52(text);
+    this.renderer.clearSelection();
+    this.statusBar.showTemporaryMessage("Copied!");
+    return true;
+  }
   enterSearch() {
     this.searchMode = true;
     this.searchQuery = "";
@@ -2437,6 +2608,7 @@ Usage:
 Options:
   -n, --name <name=command>  Add a named process
   -c, --color <colors>       Comma-separated colors (hex or names: black, red, green, yellow, blue, magenta, cyan, white, gray, orange, purple)
+  --colors                   Auto-assign colors to processes based on their name
   --config <path>            Config file path (default: auto-detect)
   -p, --prefix               Prefixed output mode (no TUI, for CI/scripts)
   --only <a,b,...>           Only run these processes (+ their dependencies)
@@ -2614,6 +2786,13 @@ async function main() {
   if (parsed.only || parsed.exclude) {
     config = filterConfig(config, parsed.only, parsed.exclude);
   }
+  if (parsed.autoColors) {
+    for (const [name, proc] of Object.entries(config.processes)) {
+      if (!proc.color) {
+        proc.color = colorFromName(name);
+      }
+    }
+  }
   const manager = new ProcessManager(config);
   let logWriter;
   if (parsed.logDir) {

package/dist/types.d.ts

@@ -14,6 +14,7 @@ export interface NumuxProcessConfig {
     color?: string | string[];
     watch?: string | string[];
     interactive?: boolean;
+    errorMatcher?: boolean | string;
 }
 /** Config for npm: wildcard entries — command is derived from package.json scripts */
 export type NumuxScriptPattern = Omit<NumuxProcessConfig, 'command'> & {
@@ -50,4 +51,7 @@ export type ProcessEvent = {
     type: 'exit';
     name: string;
     code: number | null;
+} | {
+    type: 'error';
+    name: string;
 };

package/package.json

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