porthub

See what's using your ports. Kill it.

Quick Start

npx porthub 3000

That's it. No install, no config.

Usage

# See what's on a port
porthub 3000

# Kill it immediately
porthub 3000 --kill

# Check multiple ports
porthub 3000 4000 8080

# Kill multiple
porthub 3000 4000 --kill

# See all listening ports
porthub --scan

# Kill + verify it's free
porthub 3000 --free

Example Output

  ┌────────────────────────────────────────────────────────────┐
  │  PORT    PID       PROCESS           UPTIME      MEMORY   │
  ├────────────────────────────────────────────────────────────┤
  │  3000    14523     node              2h 14m      128MB    │
  └────────────────────────────────────────────────────────────┘

  Kill node on port 3000? (y/N)

  ✓ Killed node (PID 14523) on port 3000

Install

# Use directly (no install)
npx porthub 3000

# Or install globally
npm i -g porthub

Why porthub?

| | porthub | kill-port | fkill-cli | |---|---|---|---| | Port → process info table | Yes | No | Verbose flag | | Memory & uptime per process | Yes | No | CPU/mem % | | Scan all listening ports | Yes | No | No | | Interactive kill prompt | Yes | No | Yes | | Cross-platform | Yes | Yes | Yes | | Zero-config npx usage | Yes | Yes | Yes | | Dependencies | 1 | 2 | 11 |

Cross-Platform

Works on macOS, Linux, and Windows out of the box.

• macOS/Linux: uses lsof + ps
• Windows: uses netstat + wmic (batched for speed)

Requirements

Node.js 18+

License

MIT