numux 1.24.0 → 1.26.0

package/README.md

@@ -1,6 +1,10 @@
 # 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`
 
 ## Install
 
@@ -162,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 |
@@ -194,6 +199,7 @@ Top-level options apply to all processes (process-level settings override):
 | `env` | `Record<string, string>` | Environment variables merged into all processes (process `env` overrides per key) |
 | `envFile` | `string \| string[] \| false` | `.env` file(s) for all processes (process `envFile` replaces if set; `false` disables) |
 | `showCommand` | `boolean` | Print the command being run as the first line of output (default: `true`) |
+| `persistent` | `boolean` | Set to `false` to make all processes one-shot by default (default: `true`) |
 | `maxRestarts` | `number` | Restart limit for all processes (default: `Infinity`) |
 | `readyTimeout` | `number` | Ready timeout in ms for all processes |
 | `stopSignal` | `'SIGTERM' \| 'SIGINT' \| 'SIGHUP'` | Stop signal for all processes (default: `'SIGTERM'`) |

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.24.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,
@@ -1046,6 +1053,7 @@ function validateConfig(raw, warnings) {
   const globalEnvFile = validateEnvFile(config.envFile);
   const globalMaxRestarts = typeof config.maxRestarts === "number" && config.maxRestarts >= 0 ? config.maxRestarts : undefined;
   const globalReadyTimeout = typeof config.readyTimeout === "number" && config.readyTimeout > 0 ? config.readyTimeout : undefined;
+  const globalPersistent = typeof config.persistent === "boolean" ? config.persistent : undefined;
   const globalStopSignal = validateStopSignal(config.stopSignal);
   const globalErrorMatcher = validateErrorMatcher("(global)", config.errorMatcher);
   const globalWatch = validateStringOrStringArray(config.watch);
@@ -1062,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 = {};
@@ -1106,7 +1115,7 @@ function validateConfig(raw, warnings) {
         }
       }
     }
-    const persistent = typeof p.persistent === "boolean" ? p.persistent : true;
+    const persistent = typeof p.persistent === "boolean" ? p.persistent : globalPersistent ?? true;
     const readyPattern = p.readyPattern instanceof RegExp ? p.readyPattern : typeof p.readyPattern === "string" ? p.readyPattern : undefined;
     if (typeof readyPattern === "string") {
       try {
@@ -1166,6 +1175,7 @@ function validateConfig(raw, warnings) {
     ...prefix ? { prefix } : {},
     ...timestamps ? { timestamps } : {},
     ...killOthers ? { killOthers } : {},
+    ...killOthersOnFail ? { killOthersOnFail } : {},
     ...noWatch ? { noWatch } : {},
     ...logDir ? { logDir } : {},
     processes: validated
@@ -3184,6 +3194,7 @@ class PrefixDisplay {
   buffers = new Map;
   logWriter;
   killOthers;
+  killOthersOnFail;
   timestamps;
   stopping = false;
   startTime = 0;
@@ -3191,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();
@@ -3232,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();
@@ -3804,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

@@ -80,6 +80,12 @@ export interface NumuxConfig<K extends string = string> {
     maxRestarts?: number;
     /** Global ready timeout (ms), inherited by all processes */
     readyTimeout?: number;
+    /**
+     * Set to `false` to make all processes non-persistent (one-shot) by default.
+     * Individual processes can still override with their own `persistent` value.
+     * @default true
+     */
+    persistent?: boolean;
     /**
      * Global stop signal, inherited by all processes
      * @default 'SIGTERM'
@@ -103,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
@@ -127,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.24.0",
+  "version": "1.26.0",
   "description": "Terminal multiplexer with dependency orchestration",
   "type": "module",
   "license": "MIT",