port-hunter-cli
v1.0.1
Published
Interactive terminal UI to list and kill processes listening on TCP ports (macOS, Linux, Windows)
Downloads
274
Maintainers
Readme
port-hunter-cli
Interactive terminal UI to list TCP listening ports (with project / command hints on macOS) and end listeners after confirmation. Works on macOS, Linux, and Windows.
Install (global)
npm install -g port-hunter-cliWith pnpm:
pnpm add -g port-hunter-cliUsage
port-hunter # mouse + keyboard TUI
port-hunter --once # print table once, then exit
port-hunter --helpTUI shortcuts
- Mouse: click a port row to start kill flow (two confirmation dialogs). Click the same row again also starts the flow.
- Enter (list focused): same as activating the row (kill flow).
- Arrows / j k / wheel: move highlight only (does not open kill dialog).
- r / Refresh: rescan ports.
- q / Quit: exit.
- / : focus filter; Enter / Esc from filter returns to list.
Kill uses SIGTERM (graceful) after both confirmations.
Requirements
- Node.js 18+
- Port discovery uses
lsof/ss(Unix) ornetstat(Windows). Process details on non-macOS Unix are best-effort compared to macOS.
Publish (maintainers)
cd port-hunter-cli
npm login
npm publish --access publicUse npm version patch|minor|major before publishing when bumping versions.
License
MIT — see LICENSE.
