port-patrol
v1.0.2
Published
TUI to inspect listening ports and terminate the owning process.
Maintainers
mifwarReadme
Port Patrol
A terminal UI to inspect listening ports and terminate the owning process.
Features
- 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)
Installation
# Run directly
npx port-patrol
# Or install globally
npm install -g port-patrol
ppUsage
# Open TUI
pp
# Quick search for port 3000
pp 3000Keyboard Shortcuts
| Key | Action |
| --------- | ------------------------- |
| j / ↓ | 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 |
Port Colors
- Red - System ports (< 1024) - usually need sudo to bind
- Yellow - Registered ports (< 10000)
- Green - Dynamic/private ports (>= 10000)
Development
npm install
npm run dev
# Build
npm run buildLicense
MIT