@chengyixu/port-kill 1.0.0

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@chengyixu/port-kill",
+  "version": "1.0.0",
+  "description": "Find and kill processes on a port. Cross-platform, zero dependencies.",
+  "main": "src/index.js",
+  "bin": {
+    "port-kill": "./src/index.js"
+  },
+  "files": ["src/"],
+  "keywords": ["port", "kill", "process", "pid", "lsof", "netstat", "cli"],
+  "author": "chengyixu",
+  "license": "MIT",
+  "repository": "chengyixu/port-kill",
+  "engines": { "node": ">=18" }
+}

package/src/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+const { execSync } = require('child_process');
+const os = require('os');
+
+const port = process.argv[2];
+const signal = process.argv[3] || 'SIGTERM';
+
+if (!port || isNaN(port)) {
+  console.error('Usage: port-kill <port> [signal]');
+  console.error('Example: port-kill 3000');
+  console.error('Example: port-kill 8080 SIGKILL');
+  process.exit(1);
+}
+
+function findPid(port) {
+  const platform = os.platform();
+  try {
+    if (platform === 'win32') {
+      const out = execSync(`netstat -ano | findstr :${port}`, { encoding: 'utf8' });
+      const match = out.match(/LISTENING\s+(\d+)/);
+      return match ? parseInt(match[1]) : null;
+    } else {
+      // macOS / Linux
+      let cmd;
+      try {
+        execSync('command -v lsof', { stdio: 'ignore' });
+        cmd = `lsof -ti tcp:${port}`;
+      } catch {
+        cmd = `ss -tlnp 'sport = :${port}' | awk '/LISTEN/{split($NF,a,","); gsub(/[^0-9]/,\"\",a[1]); print a[1]}'`;
+      }
+      const out = execSync(cmd, { encoding: 'utf8' }).trim();
+      if (!out) return null;
+      return parseInt(out.split('\n')[0]);
+    }
+  } catch {
+    return null;
+  }
+}
+
+const pid = findPid(port);
+
+if (!pid) {
+  console.log(`No process found on port ${port}`);
+  process.exit(0);
+}
+
+try {
+  process.kill(pid, signal);
+  console.log(`Killed process ${pid} on port ${port} (${signal})`);
+} catch (err) {
+  console.error(`Failed to kill PID ${pid}: ${err.message}`);
+  process.exit(1);
+}