port-rescue
v0.1.0
Published
Port rescue CLI for local development
Readme
sample-cli-project
port-rescue is a development utility to detect which process is listening on a TCP port and optionally terminate it.
Why this is useful
Port conflicts are one of the most common blockers when starting local servers.
port-rescue gives:
- Fast ownership lookup for a port
- Optional one-command cleanup with
--kill - JSON output for scripting with
--json
Usage
port-rescue 3000
port-rescue 3000 --kill
port-rescue 3000 --kill --signal SIGKILL
port-rescue 3000 --jsonNotes
- This implementation targets macOS/Linux environments with
lsofavailable. - Exit code is
0when listeners are found,1when none are found,2for usage/runtime errors.
