TUI to inspect listening ports and terminate the owning process.
npm install port-patrol
A terminal UI to inspect listening ports and terminate the owning process.
- List all listening ports with process info
- Search/filter by port number or process name
- Kill processes with optional force kill (SIGKILL)
- Sort by port, PID, or process name
- Color-coded ports (system < 1024, registered < 10000, dynamic)
- Cross-platform (macOS, Linux, Windows)
``bashRun directly
npx port-patrol
Usage
bash
Open TUI
ppQuick search for port 3000
pp 3000
`$3
| Key | Action |
| --------- | ------------------------- |
|
| Move down |
| k / ↑ | Move up |
| g | Jump to top |
| G | Jump to bottom |
| / or f | Search/filter |
| Enter | Kill selected process |
| K | Force kill (SIGKILL) |
| r | Refresh list |
| s | Toggle sort field |
| o | Toggle sort order |
| Esc | Clear search / Close |
| ? | Show help |
| q | Quit |$3
- Red - System ports (< 1024) - usually need sudo to bind
- Yellow - Registered ports (< 10000)
- Green - Dynamic/private ports (>= 10000)
Development
`bash
npm install
npm run devBuild
npm run build
``MIT