localhost-port-check 1.0.0

package/README.md

@@ -0,0 +1,52 @@
+# localhost-checker
+
+CLI tool to check listening localhost ports on macOS.
+
+## Installation
+
+```bash
+npm install
+npm link  # optional: install globally as 'lh' command
+```
+
+## Usage
+
+```bash
+# Run directly
+node index.js
+
+# Or with npm
+npm start
+
+# If globally installed
+lh
+```
+
+## Output
+
+Displays a table of all listening ports with:
+- **Port**: Port number (red for < 1024, green otherwise)
+- **Address**: Bind address (127.0.0.1 = local only, * = all interfaces)
+- **PID**: Process ID
+- **Command**: Process name
+- **User**: Running user
+
+## Example
+
+```
+🔍 Localhost Listening Ports
+
+┌───────┬───────────┬───────┬───────────┬───────┐
+│ Port  │ Address   │ PID   │ Command   │ User  │
+├───────┼───────────┼───────┼───────────┼───────┤
+│ 3000  │ 127.0.0.1 │ 12345 │ node      │ user  │
+├───────┼───────────┼───────┼───────────┼───────┤
+│ 3306  │ 127.0.0.1 │ 3946  │ mysqld    │ user  │
+└───────┴───────────┴───────┴───────────┴───────┘
+
+  Total: 2 port(s) listening
+```
+
+## License
+
+ISC

package/index.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const chalk = require('chalk');
+const Table = require('cli-table3');
+
+function getListeningPorts() {
+  try {
+    // macOS: use lsof to get listening ports
+    const output = execSync(
+      'lsof -iTCP -sTCP:LISTEN -P -n 2>/dev/null || true',
+      { encoding: 'utf-8' }
+    );
+
+    const lines = output.trim().split('\n').filter(Boolean);
+    if (lines.length <= 1) return [];
+
+    const ports = [];
+    const seen = new Set();
+
+    // Skip header line
+    for (let i = 1; i < lines.length; i++) {
+      const parts = lines[i].split(/\s+/);
+      if (parts.length < 9) continue;
+
+      const command = parts[0];
+      const pid = parts[1];
+      const user = parts[2];
+      const name = parts[8] || '';
+
+      // Extract port from address (e.g., "127.0.0.1:3000" or "*:8080")
+      const portMatch = name.match(/:(\d+)$/);
+      if (!portMatch) continue;
+
+      const port = portMatch[1];
+      const address = name.replace(`:${port}`, '') || '*';
+
+      // Deduplicate by pid+port
+      const key = `${pid}:${port}`;
+      if (seen.has(key)) continue;
+      seen.add(key);
+
+      ports.push({
+        port: parseInt(port),
+        address,
+        pid,
+        command,
+        user,
+      });
+    }
+
+    return ports.sort((a, b) => a.port - b.port);
+  } catch (error) {
+    console.error(chalk.red('Error getting listening ports:'), error.message);
+    return [];
+  }
+}
+
+function displayPorts(ports) {
+  console.log();
+  console.log(chalk.bold.cyan('🔍 Localhost Listening Ports'));
+  console.log();
+
+  if (ports.length === 0) {
+    console.log(chalk.yellow('  No listening ports found.'));
+    console.log();
+    return;
+  }
+
+  const table = new Table({
+    head: [
+      chalk.white.bold('Port'),
+      chalk.white.bold('Address'),
+      chalk.white.bold('PID'),
+      chalk.white.bold('Command'),
+      chalk.white.bold('User'),
+    ],
+    style: {
+      head: [],
+      border: ['gray'],
+    },
+  });
+
+  for (const p of ports) {
+    const portColor = p.port < 1024 ? chalk.red : chalk.green;
+    const isLocalhost = p.address === '127.0.0.1' || p.address === 'localhost';
+    
+    table.push([
+      portColor.bold(p.port.toString()),
+      isLocalhost ? chalk.blue(p.address) : chalk.yellow(p.address),
+      chalk.gray(p.pid),
+      chalk.white(p.command),
+      chalk.gray(p.user),
+    ]);
+  }
+
+  console.log(table.toString());
+  console.log();
+  console.log(chalk.gray(`  Total: ${ports.length} port(s) listening`));
+  console.log();
+}
+
+// Main
+const ports = getListeningPorts();
+displayPorts(ports);

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "localhost-port-check",
+  "version": "1.0.0",
+  "description": "CLI tool to check listening localhost ports on macOS",
+  "main": "index.js",
+  "bin": {
+    "lh": "./index.js",
+    "localhost-port-check": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": ["localhost", "ports", "cli", "macos", "lsof"],
+  "author": "HizumeKazushi",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/HizumeKazushi/localhost_check.git"
+  },
+  "type": "commonjs",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5"
+  }
+}