portui

Interactive terminal UI for listening TCP ports on macOS (via lsof). Browse PIDs, processes, addresses, and users; filter and sort; kill processes with SIGTERM or SIGKILL; inspect process details; detect port conflicts.

Requirements

• macOS (uses lsof)

Install

From npm (Node.js 18+):

npm install -g portui

Or run without a global install:

npx portui

The first time you install a given version, the package downloads a prebuilt binary from GitHub Releases. Publish a matching vX.Y.Z tag and let the release workflow attach portui-darwin-arm64.tar.gz and portui-darwin-x64.tar.gz before publishing to npm.

From source (Rust 1.70+):

cargo install --path .
# or
cargo run --release

Local npm development (use the binary you built with Cargo instead of downloading):

cargo build --release
npm install

Keys

| Key | Action | | ------------------------- | ----------------------------------------------- | | q / Esc | Quit | | j / ↓, k / ↑ | Move selection | | Enter / K | Kill selected (y SIGTERM, f SIGKILL, n cancel) | | d / Tab | Toggle details pane (parent PID, FDs, conns) | | w | Toggle auto-refresh (2s interval) | | r | Manual refresh | | s | Cycle sort: port → pid → name | | / | Filter (name, user, port, PID) | | g / Home, G / End | Jump top / bottom | | ? | Help overlay |

Features

• Details pane (d/Tab) — shows port category, parent PID, open file descriptor count, and established connection count for the selected process
• SIGTERM + SIGKILL — kill prompt offers graceful termination (y) or force kill (f)
• Auto-refresh (w) — polls every 2 seconds by default; toggle on/off with w
• Port conflict detection — ports with multiple processes listening are marked with ! in the table

Build

cargo build --release
# binary: target/release/portui