numux 1.23.1 → 1.24.0

package/README.md

@@ -167,7 +167,7 @@ Template properties (color, env, dependsOn, etc.) are inherited by all matched p
 | `-s, --sort <mode>` | Tab display order: `config` (default), `alphabetical`, `topological` |
 | `--no-watch` | Disable file watching even if config has `watch` patterns |
 | `-t, --timestamps` | Add `[HH:MM:SS]` timestamps to prefixed output |
-| `--log-dir <path>` | Write per-process output to `<path>/<name>.log` |
+| `--log-dir <path>` | Persist logs to timestamped subdirs (`<path>/<timestamp>/<name>.log`) with a `latest` symlink. Path is printed on exit |
 | `--debug` | Log to `.numux/debug.log` |
 | `-h, --help` | Show help |
 | `-v, --version` | Show version |
@@ -347,6 +347,23 @@ Unmatched references are left as-is (the shell will expand `$db` as empty + `.po
 
 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.).
 
+| Key | Action |
+|-----|--------|
+| `←`/`→` or `1`-`9` | Switch tabs |
+| `F` | Search current pane |
+| `Tab` (in search) | Toggle between single-pane and all-process search |
+| `Enter`/`Shift+Enter` | Next/previous match |
+| `Esc` | Exit search |
+| `R` | Restart current process |
+| `Shift+R` | Restart all processes |
+| `S` | Stop/start current process |
+| `Y` | Copy all output |
+| `L` | Clear pane |
+| `G`/`Shift+G` | Scroll to top/bottom |
+| `PageUp`/`PageDown` | Scroll by page |
+| `Ctrl+Click` | Open link |
+| `Ctrl+C` | Quit |
+
 ## Tab icons
 
 | Icon | Status |

package/dist/numux.js

@@ -36,7 +36,7 @@ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports,
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "1.23.1",
+    version: "1.24.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -1059,6 +1059,11 @@ function validateConfig(raw, warnings) {
     globalEnv = config.env;
   }
   const sort = validateSort(config.sort);
+  const prefix = config.prefix === true ? true : undefined;
+  const timestamps = config.timestamps === true ? true : undefined;
+  const killOthers = config.killOthers === true ? true : undefined;
+  const noWatch = config.noWatch === true ? true : undefined;
+  const logDir = typeof config.logDir === "string" && config.logDir.trim() ? config.logDir.trim() : undefined;
   const validated = {};
   for (const name of names) {
     let proc = processes[name];
@@ -1156,7 +1161,15 @@ function validateConfig(raw, warnings) {
       showCommand
     };
   }
-  return { ...sort ? { sort } : {}, processes: validated };
+  return {
+    ...sort ? { sort } : {},
+    ...prefix ? { prefix } : {},
+    ...timestamps ? { timestamps } : {},
+    ...killOthers ? { killOthers } : {},
+    ...noWatch ? { noWatch } : {},
+    ...logDir ? { logDir } : {},
+    processes: validated
+  };
 }
 function validateStringOrStringArray(value) {
   if (typeof value === "string")
@@ -2307,6 +2320,197 @@ class Pane {
   }
 }
 
+// src/ui/search.ts
+class SearchController {
+  mode = false;
+  allMode = false;
+  query = "";
+  matches = [];
+  index = -1;
+  crossMatches = [];
+  crossCounts = new Map;
+  timer = null;
+  logWriter;
+  statusBar;
+  tabBar;
+  getActivePane;
+  getPane;
+  constructor(opts) {
+    this.logWriter = opts.logWriter;
+    this.statusBar = opts.statusBar;
+    this.tabBar = opts.tabBar;
+    this.getActivePane = opts.getActivePane;
+    this.getPane = opts.getPane;
+  }
+  get isActive() {
+    return this.mode;
+  }
+  get isAllMode() {
+    return this.allMode;
+  }
+  get currentMatches() {
+    return this.matches;
+  }
+  enter() {
+    this.mode = true;
+    this.query = "";
+    this.matches = [];
+    this.index = -1;
+    this.allMode = false;
+    this.crossMatches = [];
+    this.crossCounts.clear();
+    this.statusBar.setSearchMode(true);
+  }
+  exit() {
+    this.mode = false;
+    this.query = "";
+    this.matches = [];
+    this.index = -1;
+    this.allMode = false;
+    this.crossMatches = [];
+    this.crossCounts.clear();
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+    const active = this.getActivePane();
+    if (active) {
+      this.getPane(active)?.clearHighlights();
+    }
+    this.tabBar.clearSearchMatches();
+    this.statusBar.setSearchMode(false);
+  }
+  onPaneSwitch() {
+    if (this.mode && this.allMode) {
+      this.applyPaneMatches();
+    }
+  }
+  refreshHighlights() {
+    if (this.matches.length > 0) {
+      this.updateHighlights();
+    }
+  }
+  handleInput(key) {
+    if (key.name === "escape") {
+      this.exit();
+      return;
+    }
+    if (key.name === "tab") {
+      this.allMode = !this.allMode;
+      if (!this.allMode) {
+        this.crossMatches = [];
+        this.crossCounts.clear();
+        this.tabBar.clearSearchMatches();
+      }
+      this.scheduleSearch();
+      return;
+    }
+    if (key.name === "return") {
+      if (this.matches.length === 0)
+        return;
+      if (key.shift) {
+        this.index = (this.index - 1 + this.matches.length) % this.matches.length;
+      } else {
+        this.index = (this.index + 1) % this.matches.length;
+      }
+      this.scrollToMatch();
+      this.updateHighlights();
+      return;
+    }
+    if (key.name === "backspace") {
+      if (this.query.length > 0) {
+        this.query = this.query.slice(0, -1);
+        this.scheduleSearch();
+      }
+      return;
+    }
+    if (key.sequence && key.sequence.length === 1 && !key.ctrl && !key.meta) {
+      this.query += key.sequence;
+      this.scheduleSearch();
+    }
+  }
+  dispose() {
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+  }
+  scheduleSearch() {
+    this.statusBar.setSearchMode(true, this.query, this.matches.length, this.index, this.crossInfo());
+    if (this.timer)
+      clearTimeout(this.timer);
+    this.timer = setTimeout(() => {
+      this.timer = null;
+      this.runSearch();
+    }, 100);
+  }
+  async runSearch() {
+    const active = this.getActivePane();
+    if (!active)
+      return;
+    const query = this.query;
+    const allMode = this.allMode;
+    if (allMode) {
+      const allMatches = await this.logWriter.searchAll(query);
+      if (!this.mode || this.query !== query || !this.allMode)
+        return;
+      this.crossMatches = allMatches;
+      this.crossCounts.clear();
+      for (const m of allMatches) {
+        this.crossCounts.set(m.process, (this.crossCounts.get(m.process) ?? 0) + 1);
+      }
+      this.tabBar.setSearchMatches(this.crossCounts);
+      this.applyPaneMatches();
+    } else {
+      const matches = await this.logWriter.search(active, query);
+      if (!this.mode || this.query !== query || this.getActivePane() !== active)
+        return;
+      this.matches = matches;
+      this.index = matches.length > 0 ? 0 : -1;
+      this.updateHighlights();
+      if (this.index >= 0)
+        this.scrollToMatch();
+    }
+  }
+  applyPaneMatches() {
+    const active = this.getActivePane();
+    if (!active)
+      return;
+    const paneMatches = this.crossMatches.filter((m) => m.process === active).map(({ line, start, end }) => ({ line, start, end }));
+    this.matches = paneMatches;
+    this.index = paneMatches.length > 0 ? 0 : -1;
+    this.updateHighlights();
+    if (this.index >= 0)
+      this.scrollToMatch();
+  }
+  updateHighlights() {
+    const active = this.getActivePane();
+    if (!active)
+      return;
+    const pane = this.getPane(active);
+    if (!pane)
+      return;
+    if (this.matches.length > 0) {
+      pane.setHighlights(this.matches, this.index);
+    } else {
+      pane.clearHighlights();
+    }
+    this.statusBar.setSearchMode(true, this.query, this.matches.length, this.index, this.crossInfo());
+  }
+  scrollToMatch() {
+    const active = this.getActivePane();
+    if (!active || this.index < 0)
+      return;
+    const pane = this.getPane(active);
+    if (!pane)
+      return;
+    pane.scrollToLine(this.matches[this.index].line);
+  }
+  crossInfo() {
+    return this.allMode ? { totalMatches: this.crossMatches.length, processCount: this.crossCounts.size } : undefined;
+  }
+}
+
 // src/ui/status-bar.ts
 import { cyan, red, reverse, StyledText, TextRenderable, yellow } from "@opentui/core";
 function plain(text) {
@@ -2319,6 +2523,7 @@ class StatusBar {
   _searchQuery = "";
   _searchMatchCount = 0;
   _searchCurrentIndex = -1;
+  _crossProcessInfo;
   _tempMessage = null;
   _tempTimer = null;
   constructor(renderer) {
@@ -2331,11 +2536,12 @@ class StatusBar {
       paddingX: 1
     });
   }
-  setSearchMode(active, query = "", matchCount = 0, currentIndex = -1) {
+  setSearchMode(active, query = "", matchCount = 0, currentIndex = -1, crossProcessInfo) {
     this._searchMode = active;
     this._searchQuery = query;
     this._searchMatchCount = matchCount;
     this._searchCurrentIndex = currentIndex;
+    this._crossProcessInfo = crossProcessInfo;
     this.renderable.content = this.buildContent();
   }
   showTemporaryMessage(message, duration = 2000) {
@@ -2360,6 +2566,7 @@ class StatusBar {
   }
   buildSearchContent() {
     const chunks = [];
+    const isAllMode = !!this._crossProcessInfo;
     chunks.push(yellow("/"));
     if (this._searchQuery)
       chunks.push(plain(this._searchQuery));
@@ -2367,14 +2574,20 @@ class StatusBar {
     if (this._searchMatchCount === 0 && this._searchQuery) {
       chunks.push(plain("  "));
       chunks.push(red("no matches"));
-      chunks.push(plain("  Esc: close"));
     } else if (this._searchMatchCount > 0) {
       chunks.push(plain("  "));
-      chunks.push(cyan(`${this._searchCurrentIndex + 1}/${this._searchMatchCount}`));
-      chunks.push(plain("  Enter/Shift+Enter: next/prev  Esc: close"));
+      if (isAllMode) {
+        const { totalMatches, processCount } = this._crossProcessInfo;
+        chunks.push(cyan(`${this._searchCurrentIndex + 1}/${this._searchMatchCount}`));
+        chunks.push(plain(`  ${totalMatches} in ${processCount} process${processCount === 1 ? "" : "es"}`));
+      } else {
+        chunks.push(cyan(`${this._searchCurrentIndex + 1}/${this._searchMatchCount}`));
+      }
+      chunks.push(plain("  Enter: next"));
     } else {
-      chunks.push(plain("  Enter: next  Esc: close"));
+      chunks.push(plain("  Enter: next"));
     }
+    chunks.push(plain(`  Tab: ${isAllMode ? "single" : "all"}  Esc: close`));
     return new StyledText(chunks);
   }
 }
@@ -2422,12 +2635,13 @@ function getDisplayOrder(originalNames, statuses) {
   const terminal = originalNames.filter((n) => TERMINAL_STATUSES.has(statuses.get(n)));
   return [...active, ...terminal];
 }
-function resolveOptionColors(names, statuses, processColors, inputWaiting, erroredProcesses) {
+function resolveOptionColors(names, statuses, processColors, inputWaiting, erroredProcesses, searchMatchProcesses) {
   return names.map((name) => {
     const status = statuses.get(name);
     const waiting = inputWaiting.has(name);
     const errored = erroredProcesses.has(name);
-    const statusHex = waiting ? "#ffaa00" : errored ? "#ff5555" : STATUS_ICON_HEX[status];
+    const hasSearchMatch = searchMatchProcesses?.has(name);
+    const statusHex = hasSearchMatch ? "#b58900" : waiting ? "#ffaa00" : errored ? "#ff5555" : STATUS_ICON_HEX[status];
     const processHex = processColors.get(name);
     return {
       iconHex: statusHex ?? processHex ?? "#888888",
@@ -2512,6 +2726,7 @@ class TabBar {
   processColors;
   inputWaiting = new Set;
   erroredProcesses = new Set;
+  searchMatchCounts = new Map;
   constructor(renderer, names, colors) {
     this.originalNames = names;
     this.names = [...names];
@@ -2569,6 +2784,14 @@ class TabBar {
       this.erroredProcesses.delete(name);
     this.refreshOptions();
   }
+  setSearchMatches(counts) {
+    this.searchMatchCounts = counts;
+    this.refreshOptions();
+  }
+  clearSearchMatches() {
+    this.searchMatchCounts.clear();
+    this.refreshOptions();
+  }
   getNameAtIndex(index) {
     return this.names[index];
   }
@@ -2590,6 +2813,10 @@ class TabBar {
     this.updateOptionColors();
   }
   getDescription(name) {
+    const matchCount = this.searchMatchCounts.get(name);
+    if (matchCount != null && matchCount > 0) {
+      return `${matchCount} match${matchCount === 1 ? "" : "es"}`;
+    }
     if (this.inputWaiting.has(name))
       return "awaiting input";
     if (this.erroredProcesses.has(name))
@@ -2597,7 +2824,8 @@ class TabBar {
     return this.baseDescriptions.get(name) ?? "pending";
   }
   updateOptionColors() {
-    const resolved = resolveOptionColors(this.names, this.statuses, this.processColors, this.inputWaiting, this.erroredProcesses);
+    const searchProcesses = this.searchMatchCounts.size > 0 ? new Set(this.searchMatchCounts.keys()) : undefined;
+    const resolved = resolveOptionColors(this.names, this.statuses, this.processColors, this.inputWaiting, this.erroredProcesses, searchProcesses);
     const colors = resolved.map((c) => ({
       icon: parseColor(c.iconHex),
       name: c.nameHex ? parseColor(c.nameHex) : null
@@ -2622,6 +2850,7 @@ class App {
   panes = new Map;
   tabBar;
   statusBar;
+  search;
   activePane = null;
   destroyed = false;
   names;
@@ -2631,11 +2860,6 @@ class App {
   config;
   logWriter;
   resizeTimer = null;
-  searchTimer = null;
-  searchMode = false;
-  searchQuery = "";
-  searchMatches = [];
-  searchIndex = -1;
   inputWaitTimers = new Map;
   awaitingInput = new Set;
   constructor(manager, config, logWriter) {
@@ -2685,6 +2909,14 @@ class App {
       flexGrow: 1,
       border: false
     });
+    this.statusBar = new StatusBar(this.renderer);
+    this.search = new SearchController({
+      logWriter: this.logWriter,
+      statusBar: this.statusBar,
+      tabBar: this.tabBar,
+      getActivePane: () => this.activePane,
+      getPane: (name) => this.panes.get(name)
+    });
     for (const name of this.names) {
       const interactive = this.config.processes[name].interactive === true;
       const pane = new Pane(this.renderer, name, termCols, termRows, interactive);
@@ -2697,14 +2929,13 @@ class App {
         this.statusBar.showTemporaryMessage(`Opening ${link.url}`);
       });
       pane.onScroll(() => {
-        if (this.searchMode && this.searchMatches.length > 0 && this.activePane === name) {
-          this.updateSearchHighlights();
+        if (this.search.isActive && this.search.currentMatches.length > 0 && this.activePane === name) {
+          this.search.refreshHighlights();
         }
       });
       this.panes.set(name, pane);
       paneContainer.add(pane.scrollBox);
     }
-    this.statusBar = new StatusBar(this.renderer);
     contentRow.add(sidebar);
     contentRow.add(paneContainer);
     layout.add(contentRow);
@@ -2746,8 +2977,8 @@ class App {
     this.renderer.keyInput.on("keypress", (key) => {
       log(key);
       if (key.ctrl && key.name === "c") {
-        if (this.searchMode) {
-          this.exitSearch();
+        if (this.search.isActive) {
+          this.search.exit();
           return;
         }
         this.shutdown().then(() => {
@@ -2755,8 +2986,8 @@ class App {
         });
         return;
       }
-      if (this.searchMode) {
-        this.handleSearchInput(key);
+      if (this.search.isActive) {
+        this.search.handleInput(key);
         return;
       }
       if (!this.activePane)
@@ -2781,7 +3012,7 @@ class App {
           return;
         }
         if (name === SHORTCUTS.search.key) {
-          this.enterSearch();
+          this.search.enter();
           return;
         }
         if (name === SHORTCUTS.restart.key) {
@@ -2845,14 +3076,16 @@ class App {
   switchPane(name) {
     if (this.activePane === name)
       return;
-    if (this.searchMode) {
-      this.exitSearch();
+    if (this.search.isActive && !this.search.isAllMode) {
+      this.search.exit();
     }
     if (this.activePane) {
+      this.panes.get(this.activePane)?.clearHighlights();
       this.panes.get(this.activePane)?.hide();
     }
     this.activePane = name;
     this.panes.get(name)?.show();
+    this.search.onPaneSwitch();
   }
   checkInputWaiting(name, data) {
     const existing = this.inputWaitTimers.get(name);
@@ -2913,102 +3146,6 @@ class App {
     this.copyToClipboard(text);
     this.statusBar.showTemporaryMessage("Copied all output!");
   }
-  enterSearch() {
-    this.searchMode = true;
-    this.searchQuery = "";
-    this.searchMatches = [];
-    this.searchIndex = -1;
-    this.statusBar.setSearchMode(true);
-  }
-  exitSearch() {
-    this.searchMode = false;
-    this.searchQuery = "";
-    this.searchMatches = [];
-    this.searchIndex = -1;
-    if (this.searchTimer) {
-      clearTimeout(this.searchTimer);
-      this.searchTimer = null;
-    }
-    if (this.activePane) {
-      this.panes.get(this.activePane)?.clearHighlights();
-    }
-    this.statusBar.setSearchMode(false);
-  }
-  handleSearchInput(key) {
-    if (key.name === "escape") {
-      this.exitSearch();
-      return;
-    }
-    if (key.name === "return") {
-      if (this.searchMatches.length === 0)
-        return;
-      if (key.shift) {
-        this.searchIndex = (this.searchIndex - 1 + this.searchMatches.length) % this.searchMatches.length;
-      } else {
-        this.searchIndex = (this.searchIndex + 1) % this.searchMatches.length;
-      }
-      this.scrollToCurrentMatch();
-      this.updateSearchHighlights();
-      return;
-    }
-    if (key.name === "backspace") {
-      if (this.searchQuery.length > 0) {
-        this.searchQuery = this.searchQuery.slice(0, -1);
-        this.scheduleSearch();
-      }
-      return;
-    }
-    if (key.sequence && key.sequence.length === 1 && !key.ctrl && !key.meta) {
-      this.searchQuery += key.sequence;
-      this.scheduleSearch();
-    }
-  }
-  scheduleSearch() {
-    this.statusBar.setSearchMode(true, this.searchQuery, this.searchMatches.length, this.searchIndex);
-    if (this.searchTimer)
-      clearTimeout(this.searchTimer);
-    this.searchTimer = setTimeout(() => {
-      this.searchTimer = null;
-      this.runSearch();
-    }, 100);
-  }
-  async runSearch() {
-    if (!this.activePane)
-      return;
-    const query = this.searchQuery;
-    const activeName = this.activePane;
-    const matches = await this.logWriter.search(activeName, query);
-    if (!this.searchMode || this.searchQuery !== query || this.activePane !== activeName)
-      return;
-    this.searchMatches = matches;
-    this.searchIndex = matches.length > 0 ? 0 : -1;
-    this.updateSearchHighlights();
-    if (this.searchIndex >= 0) {
-      this.scrollToCurrentMatch();
-    }
-  }
-  updateSearchHighlights() {
-    if (!this.activePane)
-      return;
-    const pane = this.panes.get(this.activePane);
-    if (!pane)
-      return;
-    if (this.searchMatches.length > 0) {
-      pane.setHighlights(this.searchMatches, this.searchIndex);
-    } else {
-      pane.clearHighlights();
-    }
-    this.statusBar.setSearchMode(true, this.searchQuery, this.searchMatches.length, this.searchIndex);
-  }
-  scrollToCurrentMatch() {
-    if (!this.activePane || this.searchIndex < 0)
-      return;
-    const pane = this.panes.get(this.activePane);
-    if (!pane)
-      return;
-    const match = this.searchMatches[this.searchIndex];
-    pane.scrollToLine(match.line);
-  }
   async shutdown() {
     if (this.destroyed)
       return;
@@ -3017,10 +3154,7 @@ class App {
       clearTimeout(this.resizeTimer);
       this.resizeTimer = null;
     }
-    if (this.searchTimer) {
-      clearTimeout(this.searchTimer);
-      this.searchTimer = null;
-    }
+    this.search.dispose();
     for (const timer of this.inputWaitTimers.values()) {
       clearTimeout(timer);
     }
@@ -3224,9 +3358,9 @@ ${DIM}Done in ${elapsed}${RESET}
 }
 
 // src/utils/log-writer.ts
-import { closeSync, mkdirSync as mkdirSync2, openSync, rmSync, writeSync } from "fs";
+import { closeSync, mkdirSync as mkdirSync2, openSync, rmSync, symlinkSync, unlinkSync, writeSync } from "fs";
 import { tmpdir } from "os";
-import { join } from "path";
+import { basename as basename2, join } from "path";
 class LogWriter {
   dir;
   isTemp;
@@ -3242,6 +3376,30 @@ class LogWriter {
     const dir = join(tmpdir(), `numux-${process.pid}`);
     return new LogWriter(dir, true);
   }
+  static createPersistent(baseDir) {
+    mkdirSync2(baseDir, { recursive: true });
+    const now = new Date;
+    const ts = now.toISOString().replace(/:/g, "-").replace(/\.\d+Z$/, "");
+    const sessionDir = join(baseDir, ts);
+    mkdirSync2(sessionDir, { recursive: true });
+    const latestLink = join(baseDir, "latest");
+    try {
+      unlinkSync(latestLink);
+    } catch {}
+    try {
+      symlinkSync(sessionDir, latestLink);
+    } catch {}
+    return new LogWriter(sessionDir, false);
+  }
+  get isTemporary() {
+    return this.isTemp;
+  }
+  getDirectory() {
+    return this.dir;
+  }
+  getProcessNames() {
+    return [...this.files.keys()];
+  }
   errored = false;
   handleEvent = (event) => {
     if (event.type !== "output" || this.errored)
@@ -3313,6 +3471,58 @@ class LogWriter {
       return [];
     }
   }
+  async searchAll(query) {
+    if (!query)
+      return [];
+    const paths = [...this.files.keys()].map((name) => join(this.dir, `${name}.log`));
+    if (paths.length === 0)
+      return [];
+    try {
+      const proc = Bun.spawn(["grep", "-inFH", query, ...paths], {
+        stdout: "pipe",
+        stderr: "ignore"
+      });
+      const output = await new Response(proc.stdout).text();
+      await proc.exited;
+      const matches = [];
+      const lowerQuery = query.toLowerCase();
+      for (const line of output.split(`
+`)) {
+        if (!line)
+          continue;
+        const firstColon = line.indexOf(":");
+        if (firstColon === -1)
+          continue;
+        const filePath = line.slice(0, firstColon);
+        const rest = line.slice(firstColon + 1);
+        const secondColon = rest.indexOf(":");
+        if (secondColon === -1)
+          continue;
+        const lineNumber = Number.parseInt(rest.slice(0, secondColon), 10);
+        if (Number.isNaN(lineNumber))
+          continue;
+        const fileName = basename2(filePath);
+        const processName = fileName.replace(/\.log$/, "");
+        const lineText = rest.slice(secondColon + 1).toLowerCase();
+        let pos = 0;
+        while (true) {
+          const idx = lineText.indexOf(lowerQuery, pos);
+          if (idx === -1)
+            break;
+          matches.push({
+            process: processName,
+            line: lineNumber - 1,
+            start: idx,
+            end: idx + query.length
+          });
+          pos = idx + 1;
+        }
+      }
+      return matches;
+    } catch {
+      return [];
+    }
+  }
   truncate(name) {
     const fd = this.files.get(name);
     if (fd === undefined)
@@ -3349,6 +3559,10 @@ function setupShutdownHandlers(app, logWriter) {
     }
     shuttingDown = true;
     app.shutdown().finally(() => {
+      if (logWriter && !logWriter.isTemporary) {
+        process.stderr.write(`Logs saved to: ${logWriter.getDirectory()}
+`);
+      }
       logWriter?.cleanup();
       process.exit(app.hasFailures() ? 1 : 0);
     });
@@ -3561,7 +3775,7 @@ async function main() {
       proc.envFile = parsed.envFile;
     }
   }
-  if (parsed.noWatch) {
+  if (parsed.noWatch || config.noWatch) {
     for (const proc of Object.values(config.processes)) {
       delete proc.watch;
     }
@@ -3577,9 +3791,11 @@ async function main() {
     }
   }
   const manager = new ProcessManager(config);
-  const logWriter = parsed.logDir ? new LogWriter(parsed.logDir) : LogWriter.createTemp();
+  const logDir = parsed.logDir ?? config.logDir;
+  const logWriter = logDir ? LogWriter.createPersistent(logDir) : LogWriter.createTemp();
   printWarnings(warnings);
-  if (parsed.prefix) {
+  const usePrefix = parsed.prefix || config.prefix;
+  if (usePrefix) {
     if (!parsed.noRestart) {
       for (const proc of Object.values(config.processes)) {
         proc.maxRestarts ??= 0;
@@ -3587,8 +3803,8 @@ async function main() {
     }
     const display = new PrefixDisplay(manager, config, {
       logWriter,
-      killOthers: parsed.killOthers,
-      timestamps: parsed.timestamps
+      killOthers: parsed.killOthers || config.killOthers,
+      timestamps: parsed.timestamps || config.timestamps
     });
     await display.start();
   } else {

package/dist/types.d.ts

@@ -95,6 +95,25 @@ export interface NumuxConfig<K extends string = string> {
      * @default 'config'
      */
     sort?: SortOrder;
+    /**
+     * Use prefixed output mode instead of TUI (for CI/scripts)
+     * @default false
+     */
+    prefix?: boolean;
+    /** Add timestamps to prefixed output lines (only applies when `prefix` is true) */
+    timestamps?: boolean;
+    /**
+     * Kill all processes when any one exits
+     * @default false
+     */
+    killOthers?: boolean;
+    /**
+     * Disable file watching even if processes have watch patterns
+     * @default false
+     */
+    noWatch?: boolean;
+    /** Directory to write per-process log files */
+    logDir?: string;
     processes: Record<K, NumuxProcessConfig<K> | NumuxScriptPattern<K> | string>;
 }
 export type SortOrder = 'config' | 'alphabetical' | 'topological';
@@ -105,6 +124,11 @@ export interface ResolvedProcessConfig extends Omit<NumuxProcessConfig, 'depends
 /** Validated config with all shorthand expanded to full objects */
 export interface ResolvedNumuxConfig {
     sort?: SortOrder;
+    prefix?: boolean;
+    timestamps?: boolean;
+    killOthers?: boolean;
+    noWatch?: boolean;
+    logDir?: string;
     processes: Record<string, ResolvedProcessConfig>;
 }
 export type ProcessStatus = 'pending' | 'starting' | 'ready' | 'running' | 'stopping' | 'stopped' | 'finished' | 'failed' | 'skipped';
@@ -131,3 +155,10 @@ export type ProcessEvent = {
     type: 'error';
     name: string;
 };
+export interface KeyEvent {
+    ctrl: boolean;
+    shift: boolean;
+    meta: boolean;
+    name: string;
+    sequence: string;
+}

package/package.json

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