bgrun 3.12.24 → 3.12.26

package/README.md

@@ -719,16 +719,24 @@ Not directly — bgrun manages processes on the local machine. For remote manage
 
 ---
 
-## Custom Log Paths
-
-By default, logs go to `~/.bgr/<name>-out.txt` and `~/.bgr/<name>-err.txt`. Override with:
+## Custom Log Paths
+
+By default, logs go to `~/.bgr/<name>-out.txt` and `~/.bgr/<name>-err.txt`. Override with:
 
 ```bash
-bgrun --name api \
-    --command "bun run server.ts" \
-    --stdout /var/log/api/stdout.log \
-    --stderr /var/log/api/stderr.log
-```
+bgrun --name api \
+    --command "bun run server.ts" \
+    --stdout /var/log/api/stdout.log \
+    --stderr /var/log/api/stderr.log
+```
+
+Or provide a directory and let `bgrun` derive both log filenames from the process name:
+
+```bash
+bgrun --name api \
+    --command "bun run server.ts" \
+    --logs-dir /var/log/api
+```
 
 ---
 

package/dist/api.js

@@ -240,7 +240,7 @@ function ensureDir(dirPath) {
 }
 function getShellCommand(command) {
   if (isWindows()) {
-    return ["cmd", "/c", command];
+    return [process.env.ComSpec || "cmd.exe", "/c", command];
   } else {
     return ["sh", "-c", command];
   }
@@ -1184,7 +1184,8 @@ async function loadConfigEnv(directory, configPath = ".config.toml") {
 // src/commands/run.ts
 var {$: $2 } = globalThis.Bun;
 var {sleep: sleep2 } = globalThis.Bun;
-import { join as join5 } from "path";
+import { mkdirSync as mkdirSync3 } from "fs";
+import { dirname as dirname2, join as join5 } from "path";
 import { createMeasure as createMeasure2 } from "measure-fn";
 
 // src/watcher.ts
@@ -1427,6 +1428,78 @@ function getRecentGuardEvents(limit = 100) {
 var homePath2 = getHomeDir();
 var run = createMeasure2("run");
 var INTERNAL_BUNX_PREFIX = "bunx bgrun";
+async function resolveSpawnedProcessPid(parentPid, command, workdir) {
+  if (parentPid <= 0)
+    return 0;
+  let candidatePid = parentPid;
+  const spawnedAt = Date.now();
+  for (let attempt = 0;attempt < 6; attempt++) {
+    const descendantPid = await findChildPid(parentPid);
+    if (descendantPid > 0) {
+      candidatePid = descendantPid;
+    }
+    if (candidatePid > 0 && await isProcessRunning(candidatePid, command)) {
+      return candidatePid;
+    }
+    await sleep2(250);
+  }
+  const reconciled = await reconcileProcessPids([{ name: "__spawn__", pid: parentPid, command, workdir }], new Set([parentPid]));
+  const matchedPid = reconciled.get("__spawn__") ?? 0;
+  if (matchedPid > 0 && await isProcessRunning(matchedPid, command)) {
+    return matchedPid;
+  }
+  if (process.platform === "win32") {
+    try {
+      const commandParts = command.toLowerCase().split(/\s+/).map((part) => part.trim()).filter((part) => part.length > 2);
+      const output = await psExec(`Get-CimInstance Win32_Process -Filter "Name='bun.exe'" | ` + `ForEach-Object { Write-Output "$($_.ProcessId)|$($_.ParentProcessId)|$($_.CreationDate)|$($_.CommandLine)" }`, 5000);
+      let bestPid = 0;
+      let bestScore = -1;
+      for (const line of output.split(`
+`)) {
+        const parts = line.split("|");
+        if (parts.length < 4)
+          continue;
+        const pid = parseInt(parts[0]?.trim(), 10);
+        const candidateParentPid = parseInt(parts[1]?.trim(), 10);
+        const creationDateRaw = parts[2]?.trim() || "";
+        const candidateCommand = parts.slice(3).join("|").trim().toLowerCase();
+        if (isNaN(pid) || pid <= 0 || pid === process.pid)
+          continue;
+        if (!candidateCommand)
+          continue;
+        let score = 0;
+        if (candidateParentPid === parentPid)
+          score += 10;
+        for (const part of commandParts) {
+          if (candidateCommand.includes(part))
+            score += 2;
+        }
+        if (candidateCommand.includes("run server.ts"))
+          score += 2;
+        if (candidateCommand.includes(workdir.toLowerCase().replace(/\\/g, "/")))
+          score += 4;
+        if (candidateCommand.includes(workdir.toLowerCase()))
+          score += 4;
+        const createdAt = creationDateRaw ? Date.parse(creationDateRaw) : NaN;
+        if (!isNaN(createdAt)) {
+          const ageMs = Math.abs(createdAt - spawnedAt);
+          if (ageMs <= 15000)
+            score += 6;
+          else if (ageMs <= 60000)
+            score += 2;
+        }
+        if (score > bestScore && await isProcessRunning(pid, command)) {
+          bestScore = score;
+          bestPid = pid;
+        }
+      }
+      if (bestScore >= 4) {
+        return bestPid;
+      }
+    } catch {}
+  }
+  return 0;
+}
 function resolveInternalBgrunCommand(command) {
   const trimmed = command.trim();
   if (!trimmed.startsWith("bgrun --_") && !trimmed.startsWith(`${INTERNAL_BUNX_PREFIX} --_`)) {
@@ -1446,6 +1519,7 @@ async function handleRun(options) {
     configPath,
     force,
     fetch,
+    logsDir,
     stdout,
     stderr
   } = options;
@@ -1625,9 +1699,11 @@ async function handleRun(options) {
         console.log(`Config file '${finalConfigPath}' not found, continuing without it.`);
       }
     }
-    const stdoutPath = stdout || existingProcess?.stdout_path || join5(homePath2, ".bgr", `${name}-out.txt`);
+    const stdoutPath = stdout || (logsDir ? join5(logsDir, `${name}-out.txt`) : undefined) || existingProcess?.stdout_path || join5(homePath2, ".bgr", `${name}-out.txt`);
+    mkdirSync3(dirname2(stdoutPath), { recursive: true });
     Bun.write(stdoutPath, "");
-    const stderrPath = stderr || existingProcess?.stderr_path || join5(homePath2, ".bgr", `${name}-err.txt`);
+    const stderrPath = stderr || (logsDir ? join5(logsDir, `${name}-err.txt`) : undefined) || existingProcess?.stderr_path || join5(homePath2, ".bgr", `${name}-err.txt`);
+    mkdirSync3(dirname2(stderrPath), { recursive: true });
     Bun.write(stderrPath, "");
     const actualPid = await run.measure(`Spawn "${name}" \u2192 ${finalCommand}`, async () => {
       const newProcess = Bun.spawn(getShellCommand(finalCommand), {
@@ -1637,11 +1713,13 @@ async function handleRun(options) {
         stderr: Bun.file(stderrPath)
       });
       newProcess.unref();
-      await sleep2(100);
-      const pid = await findChildPid(newProcess.pid);
-      await sleep2(400);
-      return pid;
+      return await resolveSpawnedProcessPid(newProcess.pid, finalCommand, finalDirectory);
     }) ?? 0;
+    if (actualPid <= 0) {
+      throw new Error(`Failed to resolve a live PID for "${name}" after launch. The child process likely exited immediately. Check logs:
+stdout: ${stdoutPath}
+stderr: ${stderrPath}`);
+    }
     await retryDatabaseOperation(() => insertProcess({
       pid: actualPid,
       workdir: finalDirectory,

package/dist/deploy.js

@@ -240,7 +240,7 @@ function ensureDir(dirPath) {
 }
 function getShellCommand(command) {
   if (isWindows()) {
-    return ["cmd", "/c", command];
+    return [process.env.ComSpec || "cmd.exe", "/c", command];
   } else {
     return ["sh", "-c", command];
   }
@@ -1183,7 +1183,8 @@ async function loadConfigEnv(directory, configPath = ".config.toml") {
 // src/commands/run.ts
 var {$: $2 } = globalThis.Bun;
 var {sleep: sleep2 } = globalThis.Bun;
-import { join as join5 } from "path";
+import { mkdirSync as mkdirSync3 } from "fs";
+import { dirname as dirname2, join as join5 } from "path";
 import { createMeasure as createMeasure2 } from "measure-fn";
 
 // src/watcher.ts
@@ -1426,6 +1427,78 @@ function getRecentGuardEvents(limit = 100) {
 var homePath2 = getHomeDir();
 var run = createMeasure2("run");
 var INTERNAL_BUNX_PREFIX = "bunx bgrun";
+async function resolveSpawnedProcessPid(parentPid, command, workdir) {
+  if (parentPid <= 0)
+    return 0;
+  let candidatePid = parentPid;
+  const spawnedAt = Date.now();
+  for (let attempt = 0;attempt < 6; attempt++) {
+    const descendantPid = await findChildPid(parentPid);
+    if (descendantPid > 0) {
+      candidatePid = descendantPid;
+    }
+    if (candidatePid > 0 && await isProcessRunning(candidatePid, command)) {
+      return candidatePid;
+    }
+    await sleep2(250);
+  }
+  const reconciled = await reconcileProcessPids([{ name: "__spawn__", pid: parentPid, command, workdir }], new Set([parentPid]));
+  const matchedPid = reconciled.get("__spawn__") ?? 0;
+  if (matchedPid > 0 && await isProcessRunning(matchedPid, command)) {
+    return matchedPid;
+  }
+  if (process.platform === "win32") {
+    try {
+      const commandParts = command.toLowerCase().split(/\s+/).map((part) => part.trim()).filter((part) => part.length > 2);
+      const output = await psExec(`Get-CimInstance Win32_Process -Filter "Name='bun.exe'" | ` + `ForEach-Object { Write-Output "$($_.ProcessId)|$($_.ParentProcessId)|$($_.CreationDate)|$($_.CommandLine)" }`, 5000);
+      let bestPid = 0;
+      let bestScore = -1;
+      for (const line of output.split(`
+`)) {
+        const parts = line.split("|");
+        if (parts.length < 4)
+          continue;
+        const pid = parseInt(parts[0]?.trim(), 10);
+        const candidateParentPid = parseInt(parts[1]?.trim(), 10);
+        const creationDateRaw = parts[2]?.trim() || "";
+        const candidateCommand = parts.slice(3).join("|").trim().toLowerCase();
+        if (isNaN(pid) || pid <= 0 || pid === process.pid)
+          continue;
+        if (!candidateCommand)
+          continue;
+        let score = 0;
+        if (candidateParentPid === parentPid)
+          score += 10;
+        for (const part of commandParts) {
+          if (candidateCommand.includes(part))
+            score += 2;
+        }
+        if (candidateCommand.includes("run server.ts"))
+          score += 2;
+        if (candidateCommand.includes(workdir.toLowerCase().replace(/\\/g, "/")))
+          score += 4;
+        if (candidateCommand.includes(workdir.toLowerCase()))
+          score += 4;
+        const createdAt = creationDateRaw ? Date.parse(creationDateRaw) : NaN;
+        if (!isNaN(createdAt)) {
+          const ageMs = Math.abs(createdAt - spawnedAt);
+          if (ageMs <= 15000)
+            score += 6;
+          else if (ageMs <= 60000)
+            score += 2;
+        }
+        if (score > bestScore && await isProcessRunning(pid, command)) {
+          bestScore = score;
+          bestPid = pid;
+        }
+      }
+      if (bestScore >= 4) {
+        return bestPid;
+      }
+    } catch {}
+  }
+  return 0;
+}
 function resolveInternalBgrunCommand(command) {
   const trimmed = command.trim();
   if (!trimmed.startsWith("bgrun --_") && !trimmed.startsWith(`${INTERNAL_BUNX_PREFIX} --_`)) {
@@ -1445,6 +1518,7 @@ async function handleRun(options) {
     configPath,
     force,
     fetch,
+    logsDir,
     stdout,
     stderr
   } = options;
@@ -1624,9 +1698,11 @@ async function handleRun(options) {
         console.log(`Config file '${finalConfigPath}' not found, continuing without it.`);
       }
     }
-    const stdoutPath = stdout || existingProcess?.stdout_path || join5(homePath2, ".bgr", `${name}-out.txt`);
+    const stdoutPath = stdout || (logsDir ? join5(logsDir, `${name}-out.txt`) : undefined) || existingProcess?.stdout_path || join5(homePath2, ".bgr", `${name}-out.txt`);
+    mkdirSync3(dirname2(stdoutPath), { recursive: true });
     Bun.write(stdoutPath, "");
-    const stderrPath = stderr || existingProcess?.stderr_path || join5(homePath2, ".bgr", `${name}-err.txt`);
+    const stderrPath = stderr || (logsDir ? join5(logsDir, `${name}-err.txt`) : undefined) || existingProcess?.stderr_path || join5(homePath2, ".bgr", `${name}-err.txt`);
+    mkdirSync3(dirname2(stderrPath), { recursive: true });
     Bun.write(stderrPath, "");
     const actualPid = await run.measure(`Spawn "${name}" \u2192 ${finalCommand}`, async () => {
       const newProcess = Bun.spawn(getShellCommand(finalCommand), {
@@ -1636,11 +1712,13 @@ async function handleRun(options) {
         stderr: Bun.file(stderrPath)
       });
       newProcess.unref();
-      await sleep2(100);
-      const pid = await findChildPid(newProcess.pid);
-      await sleep2(400);
-      return pid;
+      return await resolveSpawnedProcessPid(newProcess.pid, finalCommand, finalDirectory);
     }) ?? 0;
+    if (actualPid <= 0) {
+      throw new Error(`Failed to resolve a live PID for "${name}" after launch. The child process likely exited immediately. Check logs:
+stdout: ${stdoutPath}
+stderr: ${stderrPath}`);
+    }
     await retryDatabaseOperation(() => insertProcess({
       pid: actualPid,
       workdir: finalDirectory,

package/dist/deps.js

@@ -240,7 +240,7 @@ function ensureDir(dirPath) {
 }
 function getShellCommand(command) {
   if (isWindows()) {
-    return ["cmd", "/c", command];
+    return [process.env.ComSpec || "cmd.exe", "/c", command];
   } else {
     return ["sh", "-c", command];
   }

package/dist/index.js

@@ -241,7 +241,7 @@ function ensureDir(dirPath) {
 }
 function getShellCommand(command) {
   if (isWindows()) {
-    return ["cmd", "/c", command];
+    return [process.env.ComSpec || "cmd.exe", "/c", command];
   } else {
     return ["sh", "-c", command];
   }
@@ -1344,7 +1344,8 @@ async function loadConfigEnv(directory, configPath = ".config.toml") {
 // src/commands/run.ts
 var {$: $2 } = globalThis.Bun;
 var {sleep: sleep2 } = globalThis.Bun;
-import { join as join5 } from "path";
+import { mkdirSync as mkdirSync3 } from "fs";
+import { dirname as dirname2, join as join5 } from "path";
 import { createMeasure as createMeasure2 } from "measure-fn";
 
 // src/watcher.ts
@@ -1587,6 +1588,78 @@ function getRecentGuardEvents(limit = 100) {
 var homePath2 = getHomeDir();
 var run = createMeasure2("run");
 var INTERNAL_BUNX_PREFIX = "bunx bgrun";
+async function resolveSpawnedProcessPid(parentPid, command, workdir) {
+  if (parentPid <= 0)
+    return 0;
+  let candidatePid = parentPid;
+  const spawnedAt = Date.now();
+  for (let attempt = 0;attempt < 6; attempt++) {
+    const descendantPid = await findChildPid(parentPid);
+    if (descendantPid > 0) {
+      candidatePid = descendantPid;
+    }
+    if (candidatePid > 0 && await isProcessRunning(candidatePid, command)) {
+      return candidatePid;
+    }
+    await sleep2(250);
+  }
+  const reconciled = await reconcileProcessPids([{ name: "__spawn__", pid: parentPid, command, workdir }], new Set([parentPid]));
+  const matchedPid = reconciled.get("__spawn__") ?? 0;
+  if (matchedPid > 0 && await isProcessRunning(matchedPid, command)) {
+    return matchedPid;
+  }
+  if (process.platform === "win32") {
+    try {
+      const commandParts = command.toLowerCase().split(/\s+/).map((part) => part.trim()).filter((part) => part.length > 2);
+      const output = await psExec(`Get-CimInstance Win32_Process -Filter "Name='bun.exe'" | ` + `ForEach-Object { Write-Output "$($_.ProcessId)|$($_.ParentProcessId)|$($_.CreationDate)|$($_.CommandLine)" }`, 5000);
+      let bestPid = 0;
+      let bestScore = -1;
+      for (const line of output.split(`
+`)) {
+        const parts = line.split("|");
+        if (parts.length < 4)
+          continue;
+        const pid = parseInt(parts[0]?.trim(), 10);
+        const candidateParentPid = parseInt(parts[1]?.trim(), 10);
+        const creationDateRaw = parts[2]?.trim() || "";
+        const candidateCommand = parts.slice(3).join("|").trim().toLowerCase();
+        if (isNaN(pid) || pid <= 0 || pid === process.pid)
+          continue;
+        if (!candidateCommand)
+          continue;
+        let score = 0;
+        if (candidateParentPid === parentPid)
+          score += 10;
+        for (const part of commandParts) {
+          if (candidateCommand.includes(part))
+            score += 2;
+        }
+        if (candidateCommand.includes("run server.ts"))
+          score += 2;
+        if (candidateCommand.includes(workdir.toLowerCase().replace(/\\/g, "/")))
+          score += 4;
+        if (candidateCommand.includes(workdir.toLowerCase()))
+          score += 4;
+        const createdAt = creationDateRaw ? Date.parse(creationDateRaw) : NaN;
+        if (!isNaN(createdAt)) {
+          const ageMs = Math.abs(createdAt - spawnedAt);
+          if (ageMs <= 15000)
+            score += 6;
+          else if (ageMs <= 60000)
+            score += 2;
+        }
+        if (score > bestScore && await isProcessRunning(pid, command)) {
+          bestScore = score;
+          bestPid = pid;
+        }
+      }
+      if (bestScore >= 4) {
+        return bestPid;
+      }
+    } catch {}
+  }
+  return 0;
+}
 function resolveInternalBgrunCommand(command) {
   const trimmed = command.trim();
   if (!trimmed.startsWith("bgrun --_") && !trimmed.startsWith(`${INTERNAL_BUNX_PREFIX} --_`)) {
@@ -1606,6 +1679,7 @@ async function handleRun(options) {
     configPath,
     force,
     fetch,
+    logsDir,
     stdout,
     stderr
   } = options;
@@ -1785,9 +1859,11 @@ async function handleRun(options) {
         console.log(`Config file '${finalConfigPath}' not found, continuing without it.`);
       }
     }
-    const stdoutPath = stdout || existingProcess?.stdout_path || join5(homePath2, ".bgr", `${name}-out.txt`);
+    const stdoutPath = stdout || (logsDir ? join5(logsDir, `${name}-out.txt`) : undefined) || existingProcess?.stdout_path || join5(homePath2, ".bgr", `${name}-out.txt`);
+    mkdirSync3(dirname2(stdoutPath), { recursive: true });
     Bun.write(stdoutPath, "");
-    const stderrPath = stderr || existingProcess?.stderr_path || join5(homePath2, ".bgr", `${name}-err.txt`);
+    const stderrPath = stderr || (logsDir ? join5(logsDir, `${name}-err.txt`) : undefined) || existingProcess?.stderr_path || join5(homePath2, ".bgr", `${name}-err.txt`);
+    mkdirSync3(dirname2(stderrPath), { recursive: true });
     Bun.write(stderrPath, "");
     const actualPid = await run.measure(`Spawn "${name}" \u2192 ${finalCommand}`, async () => {
       const newProcess = Bun.spawn(getShellCommand(finalCommand), {
@@ -1797,11 +1873,13 @@ async function handleRun(options) {
         stderr: Bun.file(stderrPath)
       });
       newProcess.unref();
-      await sleep2(100);
-      const pid = await findChildPid(newProcess.pid);
-      await sleep2(400);
-      return pid;
+      return await resolveSpawnedProcessPid(newProcess.pid, finalCommand, finalDirectory);
     }) ?? 0;
+    if (actualPid <= 0) {
+      throw new Error(`Failed to resolve a live PID for "${name}" after launch. The child process likely exited immediately. Check logs:
+stdout: ${stdoutPath}
+stderr: ${stderrPath}`);
+    }
     await retryDatabaseOperation(() => insertProcess({
       pid: actualPid,
       workdir: finalDirectory,
@@ -2870,6 +2948,7 @@ async function showHelp() {
       bunx bgrun --delete [name]    Delete a process
       bunx bgrun --clean            Remove all stopped processes
       bunx bgrun --nuke             Delete ALL processes
+      bunx bgrun --kill-port <n>    Kill whatever is currently listening on a port
 
     ${chalk7.yellow("Options:")}
       --name <string>        Process name (required for new)
@@ -2882,6 +2961,7 @@ async function showHelp() {
       --watch                Watch for file changes and auto-restart
       --hot                  Restart the managed process when files change
       --force                Force restart existing process
+      --logs-dir <path>      Directory for derived stdout/stderr logs
       --fetch                Fetch latest git changes before running
       --json                 Output in JSON format
       --filter <group>       Filter list by BGR_GROUP
@@ -2894,36 +2974,41 @@ async function showHelp() {
       --dashboard            Launch web dashboard as bgrun-managed process
       --guard                Enable per-process crash watcher
       --guard-off            Disable per-process crash watcher
+      --kill-port <number>   Kill the process currently using a port
       --port <number>        Port for dashboard (default: 3000)
       --help                 Show this help message
 
     ${chalk7.yellow("Examples:")}
       bunx bgrun -- bun run dev
       bunx bgrun --hot -- bun run index.ts
+      bunx bgrun -hl -- bun run server.ts
       bunx bgrun --no-config -- bun run script.ts
       bunx bgrun --force -- bun run server.ts
       bunx bgrun inline -- bun run dev
       Invoke-Expression (bunx bgrun --env)
       eval "$(bunx bgrun --env --shell sh)"
       bunx bgrun --dashboard
+      bunx bgrun --kill-port 3000
       bunx bgrun myapp --guard
       bunx bgrun myapp --guard-off
       bunx bgrun --name myapp --command "bun run dev" --directory . --watch
+      bunx bgrun --name myapp --logs-dir .data --command "bun run dev" --directory .
       bunx bgrun myapp --logs --lines 50
   `;
   console.log(usage);
 }
 var cliArgOptions = {
-  name: { type: "string" },
-  command: { type: "string" },
-  directory: { type: "string" },
+  name: { type: "string", short: "n" },
+  command: { type: "string", short: "c" },
+  directory: { type: "string", short: "d" },
   config: { type: "string" },
   "no-config": { type: "boolean" },
   env: { type: "boolean" },
   shell: { type: "string" },
-  watch: { type: "boolean" },
-  hot: { type: "boolean" },
-  force: { type: "boolean" },
+  watch: { type: "boolean", short: "w" },
+  hot: { type: "boolean", short: "h" },
+  force: { type: "boolean", short: "f" },
+  "logs-dir": { type: "string" },
   fetch: { type: "boolean" },
   delete: { type: "boolean" },
   nuke: { type: "boolean" },
@@ -2932,13 +3017,13 @@ var cliArgOptions = {
   stop: { type: "boolean" },
   "stop-all": { type: "boolean" },
   clean: { type: "boolean" },
-  json: { type: "boolean" },
-  logs: { type: "boolean" },
+  json: { type: "boolean", short: "j" },
+  logs: { type: "boolean", short: "l" },
   "log-stdout": { type: "boolean" },
   "log-stderr": { type: "boolean" },
   lines: { type: "string" },
   filter: { type: "string" },
-  version: { type: "boolean" },
+  version: { type: "boolean", short: "v" },
   help: { type: "boolean" },
   db: { type: "string" },
   stdout: { type: "string" },
@@ -2947,6 +3032,7 @@ var cliArgOptions = {
   guard: { type: "boolean" },
   "guard-off": { type: "boolean" },
   debug: { type: "boolean" },
+  "kill-port": { type: "string" },
   _serve: { type: "boolean" },
   "_watch-process": { type: "string" },
   port: { type: "string" }
@@ -2954,7 +3040,7 @@ var cliArgOptions = {
 async function run2() {
   const rawArgs = Bun.argv.slice(2);
   const isActionInvocation = (values2) => {
-    return Boolean(values2.dashboard || values2.guard || values2["guard-off"] || values2.version || values2.help || values2.debug || values2.nuke || values2.clean || values2["restart-all"] || values2["stop-all"] || values2.delete || values2.restart || values2.stop || values2.logs || values2["log-stdout"] || values2["log-stderr"] || values2.watch || values2.hot || values2.json || values2.filter);
+    return Boolean(values2.dashboard || values2.guard || values2["guard-off"] || values2.version || values2.help || values2.debug || values2["kill-port"] || values2.nuke || values2.clean || values2["restart-all"] || values2["stop-all"] || values2.delete || values2.restart || values2.stop || values2.logs || values2["log-stdout"] || values2["log-stderr"] || values2.watch || values2.hot || values2.json || values2.filter);
   };
   if (rawArgs[0] === "inline") {
     const parsed = parseInlineArgs(rawArgs.slice(1));
@@ -2999,6 +3085,7 @@ async function run2() {
       configPath: values2["no-config"] ? "" : values2.config,
       force: values2.force,
       fetch: values2.fetch,
+      logsDir: values2["logs-dir"],
       remoteName: "",
       dbPath: values2.db,
       stdout: values2.stdout,
@@ -3045,6 +3132,7 @@ async function run2() {
       configPath: values["no-config"] ? "" : values.config,
       force: values.force,
       fetch: values.fetch,
+      logsDir: values["logs-dir"],
       remoteName: "",
       dbPath: values.db,
       stdout: values.stdout,
@@ -3227,6 +3315,24 @@ async function run2() {
     `);
     return;
   }
+  if (values["kill-port"]) {
+    const port = parseInt(String(values["kill-port"]), 10);
+    if (isNaN(port) || port <= 0) {
+      error("Please provide a valid port number for --kill-port.");
+    }
+    const wasFree = await isPortFree(port);
+    if (wasFree) {
+      announce(`Port ${port} is already free.`, "Port Free");
+      return;
+    }
+    await killProcessOnPort(port);
+    const freed = await waitForPortFree(port, 5000);
+    if (!freed) {
+      error(`Port ${port} is still busy after attempted cleanup.`);
+    }
+    announce(`Freed port ${port}.`, "Port Cleanup");
+    return;
+  }
   if (values.nuke) {
     await handleDeleteAll();
     return;
@@ -3335,6 +3441,7 @@ async function run2() {
       directory: values.directory,
       configPath: values.config,
       force: values.force,
+      logsDir: values["logs-dir"],
       remoteName: "",
       dbPath: values.db,
       stdout: values.stdout,
@@ -3365,6 +3472,7 @@ async function run2() {
         configPath: values["no-config"] ? "" : values.config,
         force: values.force,
         fetch: values.fetch,
+        logsDir: values["logs-dir"],
         remoteName: "",
         dbPath: values.db,
         stdout: values.stdout,

package/dist/server.js

@@ -311,7 +311,7 @@ function ensureDir(dirPath) {
 }
 function getShellCommand(command) {
   if (isWindows()) {
-    return ["cmd", "/c", command];
+    return [process.env.ComSpec || "cmd.exe", "/c", command];
   } else {
     return ["sh", "-c", command];
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bgrun",
-  "version": "3.12.24",
+  "version": "3.12.26",
   "description": "bgrun — A lightweight process manager for Bun",
   "type": "module",
   "main": "./dist/api.js",