numux 1.25.0 → 1.26.0

package/README.md

@@ -1,6 +1,8 @@
 # numux
 
-Terminal multiplexer with dependency orchestration. Run multiple processes in a tabbed TUI with a dependency graph controlling startup order.
+Terminal multiplexer with dependency orchestration. Run multiple processes in a tabbed TUI with a dependency graph controlling startup order, readiness detection, and output capture between processes.
+
+Works with zero configuration — pass commands as arguments, run a script across monorepo workspaces with `-w`, or match multiple scripts with glob patterns like `'dev:*'`. For advanced setups, define a typed config with conditional processes, file watching with auto-restart, error detection, log persistence, and output capture — e.g. extract a port from one process's stdout and pass it to another process's command or env.
 
 Inspired by `sst dev` and `concurrently`
 
@@ -164,7 +166,8 @@ Template properties (color, env, dependsOn, etc.) are inherited by all matched p
 | `-p, --prefix` | Prefixed output mode (no TUI, for CI/scripts) |
 | `--only <a,b,...>` | Only run these processes (+ their dependencies) |
 | `--exclude <a,b,...>` | Exclude these processes |
-| `--kill-others` | Kill all processes when any exits |
+| `--kill-others` | Kill all processes when any exits (regardless of exit code) |
+| `--kill-others-on-fail` | Kill all processes when any exits with a non-zero exit code |
 | `--no-restart` | Disable auto-restart for crashed processes |
 | `-s, --sort <mode>` | Tab display order: `config` (default), `alphabetical`, `topological` |
 | `--no-watch` | Disable file watching even if config has `watch` patterns |

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.25.0",
+    version: "1.26.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -192,7 +192,13 @@ var FLAGS = [
     type: "boolean",
     long: "--kill-others",
     key: "killOthers",
-    description: "Kill all processes when any exits"
+    description: "Kill all processes when any exits (regardless of exit code)"
+  },
+  {
+    type: "boolean",
+    long: "--kill-others-on-fail",
+    key: "killOthersOnFail",
+    description: "Kill all processes when any exits with non-zero code"
   },
   {
     type: "boolean",
@@ -342,6 +348,7 @@ function parseArgs(argv) {
     exec: false,
     prefix: false,
     killOthers: false,
+    killOthersOnFail: false,
     timestamps: false,
     noRestart: false,
     noWatch: false,
@@ -1063,6 +1070,7 @@ function validateConfig(raw, warnings) {
   const prefix = config.prefix === true ? true : undefined;
   const timestamps = config.timestamps === true ? true : undefined;
   const killOthers = config.killOthers === true ? true : undefined;
+  const killOthersOnFail = config.killOthersOnFail === 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 = {};
@@ -1167,6 +1175,7 @@ function validateConfig(raw, warnings) {
     ...prefix ? { prefix } : {},
     ...timestamps ? { timestamps } : {},
     ...killOthers ? { killOthers } : {},
+    ...killOthersOnFail ? { killOthersOnFail } : {},
     ...noWatch ? { noWatch } : {},
     ...logDir ? { logDir } : {},
     processes: validated
@@ -3185,6 +3194,7 @@ class PrefixDisplay {
   buffers = new Map;
   logWriter;
   killOthers;
+  killOthersOnFail;
   timestamps;
   stopping = false;
   startTime = 0;
@@ -3192,6 +3202,7 @@ class PrefixDisplay {
     this.manager = manager;
     this.logWriter = options.logWriter;
     this.killOthers = options.killOthers ?? false;
+    this.killOthersOnFail = options.killOthersOnFail ?? false;
     this.timestamps = options.timestamps ?? false;
     this.noColor = "NO_COLOR" in process.env;
     const names = manager.getProcessNames();
@@ -3233,7 +3244,8 @@ class PrefixDisplay {
       this.handleStatus(event.name, event.status);
     } else if (event.type === "exit") {
       this.flushBuffer(event.name);
-      if (this.killOthers) {
+      const exitCode = this.manager.getState(event.name)?.exitCode ?? null;
+      if (this.killOthers || this.killOthersOnFail && exitCode !== 0) {
         this.killAllAndExit(event.name);
       } else {
         this.checkAllDone();
@@ -3805,6 +3817,7 @@ async function main() {
     const display = new PrefixDisplay(manager, config, {
       logWriter,
       killOthers: parsed.killOthers || config.killOthers,
+      killOthersOnFail: parsed.killOthersOnFail || config.killOthersOnFail,
       timestamps: parsed.timestamps || config.timestamps
     });
     await display.start();

package/dist/types.d.ts

@@ -109,10 +109,15 @@ export interface NumuxConfig<K extends string = string> {
     /** Add timestamps to prefixed output lines (only applies when `prefix` is true) */
     timestamps?: boolean;
     /**
-     * Kill all processes when any one exits
+     * Kill all processes when any one exits (regardless of exit code)
      * @default false
      */
     killOthers?: boolean;
+    /**
+     * Kill all processes when any one exits with a non-zero exit code
+     * @default false
+     */
+    killOthersOnFail?: boolean;
     /**
      * Disable file watching even if processes have watch patterns
      * @default false
@@ -133,6 +138,7 @@ export interface ResolvedNumuxConfig {
     prefix?: boolean;
     timestamps?: boolean;
     killOthers?: boolean;
+    killOthersOnFail?: boolean;
     noWatch?: boolean;
     logDir?: string;
     processes: Record<string, ResolvedProcessConfig>;

package/package.json

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