@avelor/whos

What process is holding that port?

Install

npm install -g @avelor/whos
# or
pnpm add -g @avelor/whos
# or
yarn global add @avelor/whos

Requires Node.js 18+ on macOS or Linux (uses lsof). Windows is not supported.

Usage

whos 3000                      # show what process is on port 3000
whos 3000 --verbose            # also show project directory and entry point
whos kill 3000                 # send SIGTERM
whos kill --force 3000         # send SIGKILL

With -V / --verbose, each process shows its project directory and entry point — useful for Node, Python, Ruby, and other interpreted runtimes:

  node  pid 4821  :3000  *:3000

  ~/dev/my-project  ›  server.js

Works for any language — compiled binaries show the working directory.

Exit code is 0 if a process was found (or killed), 1 if nothing is on that port.

License

MIT © Avelor