kport

kport is a powerful cross-platform port inspector and process killer for
developers. Instantly find what is blocking a port, safely free it, and
monitor it in real-time — all from the terminal.

CORE FEATURES
• Inspect a port: kport inspect 8080
• Free a port: kport kill 8080
• List all ports: kport list
• Scan a port range: kport inspect 3000-3010
• Kill multiple ports: kport kill 3000 3001 8080
• Kill by name: kport kill --process node

WATCH MODE (real-time monitoring)
Continuously monitor a port and auto-kill any process that binds to it:
kport watch 8080
kport watch 8080 --interval 2.5 --dry-run

SAFETY SHIELD (protect critical services)
Blocks accidental kills on SSH, DNS, databases, and Kubernetes by default:
kport kill 22 # blocked — SSH is protected
kport kill 22 --bypass-safety # override when you really mean it

DOCKER AWARENESS
Detects ports published by Docker containers even when no host process
is visible:
kport docker
kport conflicts

MCP SERVER (AI agent integration)
Run kport as an MCP server so Claude, Cursor, Copilot, and other AI
assistants can inspect and free ports on your behalf:
kport --mcp

CONFIG FILE
Set persistent defaults via .kport.json (project, home, or global):
{ "yes": true, "protected_ports": [8080, 9090] }

PLATFORM SUPPORT
Works on Linux, macOS, and Windows. Uses psutil when available for
richer process info, falls back to native OS tools (ss, lsof, netstat).

Source & docs: https://github.com/farman20ali/port-killer