portmap

Real-time terminal dashboard for every process listening on a port.

portmap ─ live port dashboard

 PORT   PID     PROCESS             STATUS   TRAFFIC
 ──────────────────────────────────────────────────────
 3000   12345   node                LISTEN   ▄▅▆▅▇█▅▄▃▂
 5432   9876    postgres            LISTEN   ▁▁▁▂▁▁▁▁▁▁
 8080   4321    python              LISTEN   ▂▃▄▅▃▂▁▁▂▃
 ──────────────────────────────────────────────────────
 / filter  ↑↓ navigate  K kill  Q quit

Install

npm install -g @davitotty/portmap

Or run without installing:

npx @davitotty/portmap

Features

• Live updates every 1.5s — always current
• Sparklines in the TRAFFIC column show recent connection activity using braille chars (▁▂▃▄▅▆▇█)
• Color coded: green = active connections, dim = idle, red = unknown/suspicious process
• Kill a port: navigate to a row and press K, confirm with y
• Filter bar: press / and type to filter by port number or process name
• Cross-platform: Linux (ss), macOS (lsof), Windows (netstat)

Keybindings

| Key | Action | |-----|--------| | ↑ / ↓ | Navigate rows | | / | Open filter bar | | K | Kill selected port (prompts confirmation) | | ESC | Clear filter / cancel | | Q | Quit |

Requirements

• Node.js ≥ 18
• Linux: ss (from iproute2, pre-installed on most distros)
• macOS: lsof (pre-installed)
• Windows: netstat (pre-installed)

License

MIT