portgrim
v0.1.0
Published
CLI to list and stop local processes by port
Downloads
2,096
Maintainers
Readme
portgrim
portgrim is a small npm CLI for local developers who need to see which processes are listening on ports and stop them quickly.
Features
- list listening local ports
- show PID and process name when available
- kill the process bound to a chosen port
- works on Windows and Unix-like systems
Install
Run without installing
npx portgrim listGlobal install
npm install -g portgrimUsage
List listeners
portgrim listExample output:
PORT PID PROCESS PROTO ADDRESS
---- ----- ------- ----- -----------------
3000 12345 node TCP 0.0.0.0:3000
5173 25252 node TCP 127.0.0.1:5173Kill a port
portgrim kill 5173Skip confirmation
portgrim kill 5173 --yesForce kill
portgrim kill 5173 --yes --forceNotes
- This tool only manages processes on the local machine.
- You may need elevated privileges for some system-owned processes.
- On Unix-like systems,
lsofmust be available.
Development
npm test
npm run lintLicense
MIT
