numux 2.8.0 → 2.10.0

package/README.md

@@ -73,6 +73,7 @@ numux
 numux init                         # Create a starter numux.config.ts
 numux validate                     # Validate config and show process dependency graph
 numux exec <name> [--] <command>   # Run a command in a process's environment
+numux logs [name]                  # Open log directory or view a process log
 numux completions <shell>          # Generate shell completions (bash, zsh, fish)
 ```
 
@@ -85,6 +86,13 @@ numux exec api -- npx prisma migrate
 numux exec web npm run build
 ```
 
+`logs` prints the log directory path, or a specific process's log contents:
+
+```sh
+numux logs           # Print log directory path
+numux logs api       # Print the api process log
+```
+
 Set up completions for your shell:
 
 ```sh
@@ -248,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`) |
@@ -352,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

@@ -31,12 +31,13 @@ var __toESM = (mod, isNodeMode, target) => {
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __require = import.meta.require;
 
 // package.json
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "2.8.0",
+    version: "2.10.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -300,6 +301,20 @@ var SUBCOMMANDS = [
       return "break";
     }
   },
+  {
+    name: "logs",
+    description: "Open the log directory or a specific process log",
+    usage: "logs [name]",
+    parse: (args, i, result) => {
+      result.logs = true;
+      const next = args[i + 1];
+      if (next !== undefined && !next.startsWith("-")) {
+        result.logsProcess = next;
+        i++;
+      }
+      return i;
+    }
+  },
   {
     name: "completions",
     description: "Generate shell completions (bash, zsh, fish)",
@@ -364,6 +379,7 @@ function parseArgs(argv) {
     init: false,
     validate: false,
     exec: false,
+    logs: false,
     prefix: false,
     killOthers: false,
     killOthersOnFail: false,
@@ -1221,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,
@@ -1951,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)));
@@ -3513,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();
     });
@@ -3925,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);
@@ -3985,6 +4008,28 @@ async function main() {
     console.info(generateCompletions(parsed.completions));
     process.exit(0);
   }
+  if (parsed.logs) {
+    const logDir2 = parsed.logDir ?? await resolveLogDir(parsed.configPath);
+    const latestDir = resolve8(logDir2, "latest");
+    const target = existsSync6(latestDir) ? latestDir : logDir2;
+    if (parsed.logsProcess) {
+      const logFile2 = resolve8(target, `${parsed.logsProcess}.log`);
+      if (!existsSync6(logFile2)) {
+        const { readdirSync } = await import("fs");
+        const files = readdirSync(target).filter((f) => f.endsWith(".log")).map((f) => f.replace(/\.log$/, ""));
+        const available = files.length > 0 ? `Available: ${files.join(", ")}` : "No log files found";
+        console.error(`No log file for "${parsed.logsProcess}". ${available}`);
+        process.exit(1);
+      }
+      const child = Bun.spawn(["cat", logFile2], {
+        stdout: "inherit",
+        stderr: "inherit"
+      });
+      process.exit(await child.exited);
+    }
+    console.info(target);
+    process.exit(0);
+  }
   if (parsed.validate) {
     const raw = expandWorkspaces(expandScriptPatterns(await loadConfig(parsed.configPath)));
     const warnings2 = [];
@@ -4161,6 +4206,15 @@ function printWarnings(warnings) {
     console.warn(`Warning: process "${w.process}": ${w.message}`);
   }
 }
+async function resolveLogDir(configPath) {
+  try {
+    const raw = await loadConfig(configPath);
+    if (typeof raw.logDir === "string" && raw.logDir.trim()) {
+      return resolve8(raw.logDir.trim());
+    }
+  } catch {}
+  return defaultLogDir(process.cwd());
+}
 main().catch((err) => {
   console.error(err instanceof Error ? err.message : err);
   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.8.0",
+  "version": "2.10.0",
   "description": "Terminal multiplexer with dependency orchestration",
   "type": "module",
   "license": "MIT",