numux 2.9.0 → 2.10.0

package/README.md

@@ -256,6 +256,7 @@ Each process accepts:
 | `readyTimeout` | `number` | — | Milliseconds to wait for `readyPattern` before failing |
 | `maxRestarts` | `number` | `0` | Max auto-restart attempts on non-zero exit (0 = no restarts) |
 | `delay` | `number` | — | Milliseconds to wait before starting the process |
+| `optional` | `boolean` | `false` | Process is visible as a tab but not started automatically. Use Alt+S to start manually |
 | `condition` | `string` | — | Env var name; process skipped if falsy. Prefix with `!` to negate |
 | `platform` | `string \| string[]` | — | OS(es) this process runs on (e.g. `'darwin'`, `'linux'`). Non-matching processes are removed; dependents still start |
 | `stopSignal` | `string` | `SIGTERM` | Signal for graceful stop (`SIGTERM`, `SIGINT`, or `SIGHUP`) |
@@ -360,6 +361,24 @@ export default defineConfig({
 
 Falsy values: unset, empty string, `"0"`, `"false"`, `"no"`, `"off"` (case-insensitive). If a conditional process is skipped, its dependents are also skipped.
 
+### Optional processes
+
+Use `optional` for tools you want visible in tabs but not auto-started (e.g. Prisma Studio, debug servers):
+
+```ts
+export default defineConfig({
+  processes: {
+    app: { command: 'bun run dev' },
+    studio: {
+      command: 'bunx prisma studio',
+      optional: true,  // shows as stopped tab, start with Alt+S
+    },
+  },
+})
+```
+
+Unlike `condition`, optional processes don't cascade — their dependents still start normally.
+
 ### Dependency orchestration
 
 Each process starts as soon as its declared `dependsOn` dependencies are ready — it does not wait for unrelated processes. If a process fails, its dependents are skipped.

package/dist/numux.js

@@ -37,7 +37,7 @@ var __require = import.meta.require;
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "2.9.0",
+    version: "2.10.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -1237,6 +1237,7 @@ function validateConfig(raw, _warnings) {
     const processWatch = validateStringOrStringArray(p.watch);
     validated[name] = {
       command: p.command,
+      ...p.optional === true ? { optional: true } : {},
       cwd: processCwd ?? globalCwd,
       env: globalEnv || processEnv ? { ...globalEnv, ...processEnv } : undefined,
       envFile: processEnvFile ?? globalEnvFile,
@@ -1967,6 +1968,12 @@ class ProcessManager {
     const launches = this.tiers.flat().map(async (name) => {
       const proc = this.config.processes[name];
       const resolve8 = readyResolvers.get(name);
+      if (proc.optional) {
+        this.updateStatus(name, "stopped");
+        this.createRunner(name);
+        resolve8();
+        return;
+      }
       const deps = proc.dependsOn ?? [];
       if (deps.length > 0) {
         await Promise.all(deps.map((d) => readyPromises.get(d)));
@@ -3529,8 +3536,8 @@ class PrefixDisplay {
       this.shutdown();
     });
     process.on("unhandledRejection", (reason) => {
-      const message = reason instanceof Error ? reason.message : String(reason);
-      process.stderr.write(`numux: unhandled rejection: ${message}
+      const stack = reason instanceof Error ? reason.stack : String(reason);
+      process.stderr.write(`numux: unhandled rejection: ${stack}
 `);
       this.shutdown();
     });
@@ -3941,10 +3948,10 @@ function setupShutdownHandlers(app, logWriter) {
     });
   });
   process.on("unhandledRejection", (reason) => {
-    const message = reason instanceof Error ? reason.message : String(reason);
-    log("Unhandled rejection:", message);
+    const stack = reason instanceof Error ? reason.stack : String(reason);
+    log("Unhandled rejection:", stack);
     app.shutdown().finally(() => {
-      process.stderr.write(`numux: unhandled rejection: ${message}
+      process.stderr.write(`numux: unhandled rejection: ${stack}
 `);
       logWriter?.cleanup();
       process.exit(1);

package/dist/types.d.ts

@@ -43,6 +43,8 @@ export interface NumuxProcessConfig<K extends string = string> {
      * @default false
      */
     interactive?: boolean;
+    /** Process is visible but not started automatically. Use Alt+S to start manually */
+    optional?: boolean;
     /** `true` = detect ANSI red output, string = regex pattern */
     errorMatcher?: boolean | string;
     /**

package/package.json

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