port-killer

A Windows CLI tool to list open ports and interactively kill the processes using them.

Prerequisites

• Windows 10 or later
• Node.js v16+ — download from https://nodejs.org

Verify you have Node.js installed:

node -v
npm -v

Installation

1. Clone or download the project

cd C:\Users\serajkhan_bamboobox
git clone <repo-url> port-killer
cd port-killer

Or if you already have the folder:

cd C:\Users\serajkhan_bamboobox\port-killer

2. Install dependencies

npm install

3. Build

This bundles everything into a single file at dist/killport.js with no runtime dependencies.

npm run build

4. Run

node dist/killport.js

Global install (run from anywhere)

After building, install globally so you can type port-killer from any terminal:

npm install -g .

Then run it from anywhere:

port-killer

To uninstall:

npm uninstall -g port-killer

Usage

node dist/killport.js           # show user-level ports only (default)
node dist/killport.js --all     # include system ports
node dist/killport.js --debug   # show what is being filtered and why

Controls

| Key | Action | |-------------|-------------------------------| | ↑ / ↓ | Move cursor | | Space | Select / deselect a process | | Enter | Confirm selection and kill | | Esc | Exit |

After killing a port the list refreshes automatically so you can kill more.

Notes

• Run your terminal as Administrator if you need to kill processes owned by other users or services.
• The dist/killport.js file is fully self-contained — you can copy it to any Windows machine with Node.js and run it directly without npm install.
• Use --all flag if your port is not showing up (it may be running under a service account).
• Use --debug to see every port and whether it is being filtered, to help diagnose missing entries.