PortNanny
Manage macOS network ports by identifying owners and safely terminating processes.
PortNanny is a comprehensive macOS port manager designed to tackle common developer frustrations like `EADDRINUSE` errors and servers that refuse to die. It provides a menu bar application, a detailed Workbench GUI, and a powerful command-line interface to monitor every listening port, identify its owner, and stop it correctly, even if supervised by tools like pm2 or Docker. A unique feature is its built-in MCP server, which enables AI agents to coordinate port usage, preventing accidental server shutdowns and ensuring smooth parallel operation.
Key Features
01Supervisor-aware termination for processes managed by tools like pm2, Docker, and `next dev`
02Multi-agent coordination via an MCP server to prevent port conflicts
031 GitHub stars
04Identify owner and process for every listening port on macOS
05Menu bar app for quick access, Workbench for detailed oversight, and a comprehensive CLI
06Port watching, guarding, leasing, and history tracking
Use Cases
01Gracefully stop supervised development servers without manual intervention
02Resolve `EADDRINUSE` errors by identifying and freeing occupied ports
03Prevent AI agents from killing each other's local servers during parallel execution