portly-cli 1.0.1 → 1.1.0

package/README.md

@@ -1,9 +1,9 @@
-# 🔍 portly-cli
+# 🔍 portly
 
-> A pretty CLI tool to explore and manage open ports. Like `lsof`, but with style.
+> A CLI tool to explore and manage open ports. Like `lsof`, but with style.
 
-![Terminal](https://img.shields.io/badge/Terminal-macOS-green)
-![Node](https://img.shields.io/badge/Node-16+-yellow)
+![Terminal](https://img.shields.io/badge/Terminal-macOS-green) ![Terminal](https://img.shields.io/badge/Terminal-Linux-green) ![Terminal](https://img.shields.io/badge/Terminal-Windows-blue)
+![npm](https://img.shields.io/badge/npm-yellow)
 
 ## 🚀 Quick Start
 
@@ -17,17 +17,6 @@ npm install -g portly-cli
 portly
 ```
 
-Or run locally:
-```bash
-# Navigate to the portly directory
-cd portly
-
-# Run the app
-node src/index.js
-# or
-npm start
-```
-
 ---
 
 ## ⌨️ Keyboard Shortcuts
@@ -131,13 +120,13 @@ When you press `K` on a port, a confirmation dialog appears:
 +----------------------------------+
 |                                  |
 |  Process: ControlCe              |
-|  PID:     602                   |
+|  PID:     602                    |
 |  Port:    5000                   |
 |                                  |
 |  Are you sure you want to kill   |
 |  this process?                   |
 |                                  |
-|        [Y] KILL    [N] CANCEL   |
+|   [Y] KILL   [N]/[ESC] CANCEL    |
 |                                  |
 +----------------------------------+
 ```
@@ -154,9 +143,10 @@ When auto-refresh is enabled (`[AUTO-ON]`), portly automatically scans every 2 s
 
 ## 🛠️ Requirements
 
-- macOS or Linux
+- macOS, Linux, or Windows
 - Node.js 16 or higher
-- `lsof` command (standard on macOS/Linux)
+- `lsof` command (macOS/Linux, standard on those platforms)
+- `netstat` and `tasklist` commands (Windows, built-in)
 
 ---
 
@@ -166,27 +156,10 @@ When auto-refresh is enabled (`[AUTO-ON]`), portly automatically scans every 2 s
 # Install globally via npm
 npm install -g portly-cli
 
-# Run
+# Run the app
 portly
 ```
 
-### For Development
-
-```bash
-# Clone the repo
-git clone <your-repo-url>
-cd portly
-
-# Install dependencies
-npm install
-
-# Run
-npm start
-
-# Or with file watching (auto-reload on changes)
-npm run dev
-```
-
 ---
 
 ## 🎨 Port States

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portly-cli",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "A pretty CLI tool to explore and manage open ports. Like lsof, but with style.",
   "main": "src/index.js",
   "bin": {

package/src/index.js

@@ -4,6 +4,9 @@ const blessed = require('blessed');
 const MainScreen = require('./ui/mainScreen');
 const { scanPorts } = require('./utils/portScanner');
 
+// Disable warnings on startup
+process.emit('warning', { name: 'DeprecationWarning', code: 'DEP', suppress: true });
+
 class Portly {
   constructor() {
     this.screen = null;
@@ -13,11 +16,12 @@ class Portly {
   }
 
   init() {
-    // Create the screen
+    // Create the screen with fallback terminal
     this.screen = blessed.screen({
       smartCSR: true,
       title: 'portly - port explorer',
-      warnings: true,
+      warnings: false,
+      terminal: process.env.TERM || 'xterm',
     });
 
     // Create main screen (binds keys internally)

package/src/ui/mainScreen.js

@@ -1,6 +1,25 @@
 const blessed = require('blessed');
 const { CATEGORY_LABELS } = require('../utils/portScanner');
 
+// Cross-platform clipboard copy
+function copyToClipboard(text) {
+  const exec = require('child_process').exec;
+  const isMac = process.platform === 'darwin';
+  const isWindows = process.platform === 'win32';
+  
+  let cmd;
+  if (isWindows) {
+    // Windows: use clip command
+    cmd = `echo ${text}| clip`;
+  } else if (isMac) {
+    cmd = `echo "${text}" | pbcopy`;
+  } else {
+    // Linux
+    cmd = `echo "${text}" | xclip -selection clipboard 2>/dev/null || echo "${text}" | xsel --clipboard 2>/dev/null || echo "Clipboard not available (install xclip)"`;
+  }
+  exec(cmd, () => {});
+}
+
 const STATUS_ICONS = {
   LISTEN: '[L]',
   ESTABLISHED: '[E]',
@@ -495,7 +514,13 @@ class MainScreen {
 
   killProcess(pid) {
     const exec = require('child_process').exec;
-    exec(`kill ${pid}`, (err) => {
+    const isWindows = process.platform === 'win32';
+    
+    const killCmd = isWindows 
+      ? `taskkill /F /PID ${pid}` 
+      : `kill ${pid}`;
+    
+    exec(killCmd, (err) => {
       if (err) {
         this.statusBar.setContent(`Failed to kill PID ${pid}: ${err.message}`);
       } else {
@@ -511,21 +536,17 @@ class MainScreen {
   }
 
   copyPort() {
-    const exec = require('child_process').exec;
     const port = this.selectedPort.port;
-    exec(`echo ${port} | pbcopy`, () => {
-      this.statusBar.setContent(`Copied port ${port} to clipboard!`);
-      this.renderStatusBar();
-    });
+    copyToClipboard(port);
+    this.statusBar.setContent(`Copied port ${port} to clipboard!`);
+    this.renderStatusBar();
   }
 
   copyPid() {
-    const exec = require('child_process').exec;
     const pid = this.selectedPort.pid;
-    exec(`echo ${pid} | pbcopy`, () => {
-      this.statusBar.setContent(`Copied PID ${pid} to clipboard!`);
-      this.renderStatusBar();
-    });
+    copyToClipboard(pid);
+    this.statusBar.setContent(`Copied PID ${pid} to clipboard!`);
+    this.renderStatusBar();
   }
 }
 

package/src/utils/portScanner.js

@@ -22,6 +22,7 @@ function getProtocolLabel(protocol) {
 function getStateLabel(state) {
   const states = {
     LISTEN: '🟢',
+    LISTENING: '🟢',
     ESTABLISHED: '🟡',
     TIME_WAIT: '⏳',
     CLOSE_WAIT: '⏳',
@@ -34,7 +35,11 @@ function getStateLabel(state) {
   return states[state] || '⚪';
 }
 
-async function scanPorts() {
+function isWindows() {
+  return process.platform === 'win32';
+}
+
+async function scanPortsMacLinux() {
   const ports = [];
   
   try {
@@ -108,4 +113,117 @@ async function scanPorts() {
   return Array.from(seen.values()).sort((a, b) => a.port - b.port);
 }
 
+async function scanPortsWindows() {
+  const ports = [];
+  
+  try {
+    // Get netstat output - parse in Node.js to handle locale differences
+    const { stdout: netstatOut } = await execAsync(
+      'netstat -ano',
+      { maxBuffer: 1024 * 1024 * 10, encoding: 'utf8' }
+    );
+    
+    // Get process list (name and PID)
+    const { stdout: tasklistOut } = await execAsync(
+      'tasklist /FO CSV /NH',
+      { maxBuffer: 1024 * 1024 * 10, encoding: 'utf8' }
+    );
+    
+    // Parse tasklist into a map: PID -> Command
+    const pidToCmd = new Map();
+    const tasklistLines = tasklistOut.split('\n');
+    for (const line of tasklistLines) {
+      const match = line.match(/"([^"]+)","(\d+)"/);
+      if (match) {
+        pidToCmd.set(match[2], match[1]);
+      }
+    }
+    
+    const lines = netstatOut.split('\n');
+    
+    for (const line of lines) {
+      if (!line.trim()) continue;
+      
+      // Skip header lines and non-TCP lines
+      if (!line.includes('TCP') || line.includes('Proto') || line.startsWith('Aktive') || line.startsWith('Active')) {
+        continue;
+      }
+      
+      const parts = line.trim().split(/\s+/);
+      if (parts.length < 5) continue;
+      
+      const protocol = parts[0]; // TCP
+      const localAddr = parts[1]; // 0.0.0.0:135 or [::]:5000
+      const pid = parseInt(parts[4], 10);
+      
+      // Check if it's a listening state by foreign address (locale-independent)
+      const foreignAddr = parts[2];
+      const isListening = /^(0\.0\.0\.0:0|\[?::\]?:0)$/.test(foreignAddr);
+      if (!isListening) continue;
+      
+      if (isNaN(pid)) continue;
+      
+      // Parse port from local address
+      let port;
+      let localAddress;
+      
+      if (localAddr.startsWith('[')) {
+        // IPv6 format: [::]:5000
+        const match = localAddr.match(/\[([^\]]+)\]:(\d+)/);
+        if (!match) continue;
+        localAddress = match[1];
+        port = parseInt(match[2], 10);
+      } else {
+        // IPv4 format: 0.0.0.0:135
+        const colonIdx = localAddr.lastIndexOf(':');
+        if (colonIdx === -1) continue;
+        localAddress = localAddr.substring(0, colonIdx);
+        port = parseInt(localAddr.substring(colonIdx + 1), 10);
+      }
+      
+      if (isNaN(port)) continue;
+      
+      const command = pidToCmd.get(String(pid)) || 'Unknown';
+      
+      // Determine protocol type (TCP4 or TCP6)
+      const protocolFull = localAddr.startsWith('[') ? 'TCP6' : 'TCP';
+      
+      ports.push({
+        command,
+        pid,
+        user: 'N/A', // Windows netstat doesn't provide user info like lsof on Unix
+        port,
+        protocol: protocol === 'TCP' ? 'TCP' : protocol,
+        protocolFull,
+        state: 'LISTEN',
+        localAddress: localAddress === '0.0.0.0' || localAddress === '::' || localAddress === '[::]' ? '*' : localAddress,
+        remoteAddress: '-',
+        category: getCategory(port),
+        stateIcon: getStateLabel('LISTEN'),
+      });
+    }
+  } catch (err) {
+    console.error('Error running netstat:', err.message);
+  }
+
+  // Deduplicate by port+protocol
+  const seen = new Map();
+  for (const p of ports) {
+    const key = `${p.port}-${p.protocol}`;
+    if (!seen.has(key)) {
+      seen.set(key, p);
+    }
+  }
+
+  // Sort by port
+  return Array.from(seen.values()).sort((a, b) => a.port - b.port);
+}
+
+async function scanPorts() {
+  if (isWindows()) {
+    return scanPortsWindows();
+  }
+  return scanPortsMacLinux();
+}
+
 module.exports = { scanPorts, getCategory, getProtocolLabel, CATEGORY_LABELS };

package/debug.log

@@ -1 +0,0 @@
-This file is just a marker.