numux 2.11.0 → 2.13.0

package/README.md

@@ -89,13 +89,6 @@ 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
@@ -227,8 +220,8 @@ export default defineConfig({
 | `-e,` `--env-file` `<path|false>` | Env file path, or "false" to disable env file loading |
 | `--config` `<path>` | Config file path (default: auto-detect) |
 | `-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 |
+| `-o,` `--only` `<a,b,...>` | Only run these processes (+ their dependencies) |
+| `-x,` `--exclude` `<a,b,...>` | Exclude these processes |
 | `--kill-others` | Kill all processes when any exits (regardless of exit code) |
 | `--kill-others-on-fail` | Kill all processes when any exits with non-zero code |
 | `--max-restarts` `<n>` | Max auto-restarts for crashed processes |
@@ -250,6 +243,20 @@ numux --prefix
 
 Auto-exits when all processes finish. Exit code 1 if any process failed.
 
+## Logging
+
+numux writes per-process log files (ANSI-stripped) when `--log-dir` is set or `logDir` is configured. Each session creates a timestamped subdirectory with a `latest` symlink pointing to the most recent run.
+
+<!-- generated:logging-usage -->
+```sh
+numux logs                         # Print log directory path
+numux logs api                     # Pipe the api process log to stdout
+numux logs api | grep "ERROR"      # Search process logs
+numux logs api | tail -f           # Follow process log output
+```
+<!-- /generated:logging-usage -->
+
+
 ## Config reference
 
 ### Global options

package/dist/man/numux.1

@@ -1,4 +1,4 @@
-.TH "NUMUX" "1" "April 2026" "2.11.0" "numux manual"
+.TH "NUMUX" "1" "April 2026" "2.13.0" "numux manual"
 .SH "NAME"
 \fBnumux\fR
 .P
@@ -97,14 +97,6 @@ numux exec web npm run build
 .fi
 .RE
 .P
-\fBlogs\fP prints the log directory path, or a specific process's log contents:
-.RS 2
-.nf
-numux logs           # Print log directory path
-numux logs api       # Print the api process log
-.fi
-.RE
-.P
 Set up completions for your shell:
 .RS 2
 .nf
@@ -309,13 +301,13 @@ Prefixed output mode (no TUI, for CI/scripts)
 T}
 _
 T{
-\fB\-\-only\fP \fB<a,b,\.\.\.>\fP
+\fB\-o,\fP \fB\-\-only\fP \fB<a,b,\.\.\.>\fP
 T}|T{
 Only run these processes (+ their dependencies)
 T}
 _
 T{
-\fB\-\-exclude\fP \fB<a,b,\.\.\.>\fP
+\fB\-x,\fP \fB\-\-exclude\fP \fB<a,b,\.\.\.>\fP
 T}|T{
 Exclude these processes
 T}
@@ -386,6 +378,21 @@ numux \-\-prefix
 .RE
 .P
 Auto\-exits when all processes finish\. Exit code 1 if any process failed\.
+.SH Logging
+.P
+numux writes per\-process log files (ANSI\-stripped) when \fB\-\-log\-dir\fP is set or \fBlogDir\fP is configured\. Each session creates a timestamped subdirectory with a \fBlatest\fP symlink pointing to the most recent run\.
+<!\-\- generated:logging\-usage \-\->
+.RS 2
+.nf
+numux logs                         # Print log directory path
+numux logs api                     # Pipe the api process log to stdout
+numux logs api | grep "ERROR"      # Search process logs
+numux logs api | tail \-f           # Follow process log output
+.fi
+.RE
+<!\-\- /generated:logging\-usage \-\->
+
+
 .SH Config reference
 .SS Global options
 .P

package/dist/numux.js

@@ -127,13 +127,6 @@ 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
@@ -245,8 +238,8 @@ export default defineConfig({
 | \`-e,\` \`--env-file\` \`<path|false>\` | Env file path, or "false" to disable env file loading |
 | \`--config\` \`<path>\` | Config file path (default: auto-detect) |
 | \`-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 |
+| \`-o,\` \`--only\` \`<a,b,...>\` | Only run these processes (+ their dependencies) |
+| \`-x,\` \`--exclude\` \`<a,b,...>\` | Exclude these processes |
 | \`--kill-others\` | Kill all processes when any exits (regardless of exit code) |
 | \`--kill-others-on-fail\` | Kill all processes when any exits with non-zero code |
 | \`--max-restarts\` \`<n>\` | Max auto-restarts for crashed processes |
@@ -264,6 +257,16 @@ numux --prefix
 \`\`\`
 
 Auto-exits when all processes finish. Exit code 1 if any process failed.` },
+    logging: { title: "Logging", body: `numux writes per-process log files (ANSI-stripped) when \`--log-dir\` is set or \`logDir\` is configured. Each session creates a timestamped subdirectory with a \`latest\` symlink pointing to the most recent run.
+
+<!-- generated:logging-usage -->
+\`\`\`sh
+numux logs                         # Print log directory path
+numux logs api                     # Pipe the api process log to stdout
+numux logs api | grep "ERROR"      # Search process logs
+numux logs api | tail -f           # Follow process log output
+\`\`\`
+<!-- /generated:logging-usage -->` },
     "global-options": { title: "Global options", body: `Top-level options apply to all processes (process-level settings override):
 
 <!-- generated:config-global -->
@@ -538,7 +541,7 @@ var init_help = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "2.11.0",
+    version: "2.13.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -800,6 +803,7 @@ var FLAGS = [
   {
     type: "value",
     long: "--only",
+    short: "-o",
     key: "only",
     description: "Only run these processes (+ their dependencies)",
     valueName: "<a,b,...>",
@@ -809,6 +813,7 @@ var FLAGS = [
   {
     type: "value",
     long: "--exclude",
+    short: "-x",
     key: "exclude",
     description: "Exclude these processes",
     valueName: "<a,b,...>",
@@ -925,6 +930,14 @@ var SUBCOMMANDS = [
     name: "logs",
     description: "Open the log directory or a specific process log",
     usage: "logs [name]",
+    examples: [
+      ["numux logs", "Print log directory path"],
+      ["numux logs api", "Pipe the api process log to stdout"],
+      ['numux logs api | grep "ERROR"', "Search process logs"],
+      ["numux logs api | tail -f", "Follow process log output"]
+    ],
+    completionArgs: "dynamic",
+    completionScript: "numux logs 2>/dev/null",
     parse: (args, i, result) => {
       result.logs = true;
       const next = args[i + 1];
@@ -939,6 +952,7 @@ var SUBCOMMANDS = [
     name: "completions",
     description: "Generate shell completions (bash, zsh, fish)",
     usage: "completions <shell>",
+    completionArgs: ["bash", "zsh", "fish"],
     parse: (args, i, result) => {
       const next = args[++i];
       if (next === undefined)
@@ -951,6 +965,7 @@ var SUBCOMMANDS = [
     name: "help",
     description: "Show help for a topic",
     usage: "help [topic]",
+    completionArgs: "dynamic",
     parse: (args, i, result) => {
       result.help = true;
       const next = args[i + 1];
@@ -1048,7 +1063,10 @@ function parseArgs(argv) {
         const value = flag.parse ? flag.parse(next, arg) : next;
         const current = result[flag.key];
         if (Array.isArray(current)) {
-          current.push(value);
+          if (Array.isArray(value))
+            current.push(...value);
+          else
+            current.push(value);
         } else {
           result[flag.key] = value;
         }
@@ -1151,6 +1169,13 @@ function filterConfig(config, only, exclude) {
 init_help_topics();
 var SUPPORTED_SHELLS = ["bash", "zsh", "fish"];
 var HELP_TOPIC_NAMES = [...Object.keys(HELP_TOPICS), ...Object.keys(TOPIC_ALIASES)];
+function resolveArgs(sub) {
+  if (!sub.completionArgs)
+    return;
+  if (sub.completionArgs === "dynamic" && sub.name === "help")
+    return HELP_TOPIC_NAMES;
+  return sub.completionArgs;
+}
 function generateCompletions(shell) {
   switch (shell) {
     case "bash":
@@ -1188,12 +1213,30 @@ function bashCompletions() {
       return ;;`);
     }
   }
-  caseEntries.push(`    completions)
-      COMPREPLY=( $(compgen -W "bash zsh fish" -- "$cur") )
+  for (const sub of SUBCOMMANDS) {
+    const args = resolveArgs(sub);
+    if (!args)
+      continue;
+    if (args === "dynamic") {
+      const script = sub.completionScript;
+      if (!script)
+        continue;
+      const dir = `$(${script})`;
+      caseEntries.push(`    ${sub.name})
+      local logdir
+      logdir="${dir}"
+      if [ -n "$logdir" ] && [ -d "$logdir" ]; then
+        local names
+        names="$(ls "$logdir"/*.log 2>/dev/null | xargs -I{} basename {} .log)"
+        COMPREPLY=( $(compgen -W "$names" -- "$cur") )
+      fi
       return ;;`);
-  caseEntries.push(`    help)
-      COMPREPLY=( $(compgen -W "${HELP_TOPIC_NAMES.join(" ")}" -- "$cur") )
+    } else {
+      caseEntries.push(`    ${sub.name})
+      COMPREPLY=( $(compgen -W "${args.join(" ")}" -- "$cur") )
       return ;;`);
+    }
+  }
   const allFlags = FLAGS.flatMap((f) => f.short ? [f.short, f.long] : [f.long]);
   const subcmds = SUBCOMMANDS.map((s) => s.name);
   return `# numux bash completions
@@ -1253,6 +1296,31 @@ function zshCompletions() {
   }
   const argsBlock = argLines.map((l) => `${l} \\`).join(`
 `);
+  const subcmdCases = [];
+  for (const sub of SUBCOMMANDS) {
+    const args = resolveArgs(sub);
+    if (!args)
+      continue;
+    if (args === "dynamic") {
+      const script = sub.completionScript;
+      if (!script)
+        continue;
+      subcmdCases.push(`    ${sub.name})
+      local logdir names
+      logdir="\\$(${script})"
+      if [[ -n "\\$logdir" ]] && [[ -d "\\$logdir" ]]; then
+        names=( \\$(ls "\\$logdir"/*.log 2>/dev/null | xargs -I{} basename {} .log) )
+        _describe 'process' names
+      fi
+      ;;`);
+    } else {
+      subcmdCases.push(`    ${sub.name})
+      local -a args
+      args=(${args.map((a) => `'${a}'`).join(" ")})
+      _describe '${sub.name}' args
+      ;;`);
+    }
+  }
   return `#compdef numux
 # numux zsh completions
 # Add to ~/.zshrc: eval "$(numux completions zsh)"
@@ -1275,14 +1343,8 @@ ${argsBlock}
   esac
 
   case "\${words[2]}" in
-    help)
-      local -a topics
-      topics=(${HELP_TOPIC_NAMES.map((t) => `'${t}'`).join(" ")})
-      _describe 'topic' topics
-      ;;
-    completions)
-      _values 'shell' bash zsh fish
-      ;;
+${subcmdCases.join(`
+`)}
   esac
 }
 _numux`;
@@ -1299,7 +1361,22 @@ function fishCompletions() {
   for (const s of SUBCOMMANDS) {
     lines.push(`complete -c numux -n __fish_use_subcommand -a ${s.name} -d '${sq(s.description)}'`);
   }
-  lines.push("", "# Completions subcommand", "complete -c numux -n '__fish_seen_subcommand_from completions' -a 'bash zsh fish'", "", "# Help subcommand", `complete -c numux -n '__fish_seen_subcommand_from help' -a '${HELP_TOPIC_NAMES.join(" ")}'`, "", "# Options");
+  for (const sub of SUBCOMMANDS) {
+    const args = resolveArgs(sub);
+    if (!args)
+      continue;
+    lines.push("");
+    lines.push(`# ${sub.name} subcommand`);
+    if (args === "dynamic") {
+      const script = sub.completionScript;
+      if (!script)
+        continue;
+      lines.push(`complete -c numux -n '__fish_seen_subcommand_from ${sub.name}' -a '(set -l d (${script}); and ls $d/*.log 2>/dev/null | xargs -I{} basename {} .log)'`);
+    } else {
+      lines.push(`complete -c numux -n '__fish_seen_subcommand_from ${sub.name}' -a '${args.join(" ")}'`);
+    }
+  }
+  lines.push("", "# Options");
   for (const f of FLAGS) {
     const parts = ["complete -c numux"];
     if (f.short)
@@ -4258,7 +4335,7 @@ class App {
         }
         if (name === SHORTCUTS.clear.key) {
           this.panes.get(this.activePane)?.clear();
-          this.logWriter.truncate(this.activePane);
+          this.logWriter.markCopyStart(this.activePane);
           return;
         }
         if (name === SHORTCUTS.timestamps.key) {
@@ -4389,10 +4466,7 @@ class App {
   copyAllText() {
     if (!this.activePane)
       return;
-    const pane = this.panes.get(this.activePane);
-    if (!pane)
-      return;
-    const text = pane.getText();
+    const text = this.logWriter.readLog(this.activePane);
     if (!text) {
       this.statusBar.showTemporaryMessage("No output to copy");
       return;
@@ -4647,13 +4721,14 @@ ${DIM}Done in ${elapsed}${RESET}
 }
 
 // src/utils/log-writer.ts
-import { closeSync, mkdirSync as mkdirSync2, openSync, rmSync, symlinkSync, unlinkSync, writeSync } from "fs";
+import { closeSync, mkdirSync as mkdirSync2, openSync, readSync, rmSync, symlinkSync, unlinkSync, writeSync } from "fs";
 import { tmpdir } from "os";
 import { basename as basename2, join } from "path";
 class LogWriter {
   dir;
   isTemp;
   files = new Map;
+  copyOffsets = new Map;
   decoder = new TextDecoder;
   encoder = new TextEncoder;
   constructor(dir, isTemp = false) {
@@ -4709,6 +4784,35 @@ class LogWriter {
 `);
     }
   };
+  markCopyStart(name) {
+    const path = this.getLogPath(name);
+    if (!path)
+      return;
+    try {
+      this.copyOffsets.set(name, Bun.file(path).size);
+    } catch {}
+  }
+  readLog(name) {
+    const path = this.getLogPath(name);
+    if (!path)
+      return;
+    try {
+      const size = Bun.file(path).size;
+      const offset = this.copyOffsets.get(name) ?? 0;
+      if (size <= offset)
+        return;
+      const fd = openSync(path, "r");
+      try {
+        const buf = Buffer.alloc(size - offset);
+        readSync(fd, buf, 0, buf.length, offset);
+        return buf.toString("utf-8");
+      } finally {
+        closeSync(fd);
+      }
+    } catch {
+      return;
+    }
+  }
   getLogPath(name) {
     if (this.files.has(name)) {
       return join(this.dir, `${name}.log`);
@@ -4812,17 +4916,6 @@ class LogWriter {
       return [];
     }
   }
-  truncate(name) {
-    const fd = this.files.get(name);
-    if (fd === undefined)
-      return;
-    try {
-      closeSync(fd);
-      const path = join(this.dir, `${name}.log`);
-      const newFd = openSync(path, "w");
-      this.files.set(name, newFd);
-    } catch {}
-  }
   close() {
     for (const fd of this.files.values()) {
       closeSync(fd);

package/package.json

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