@rusky/port-killer

A simple 2.8 kB CLI tool for finding and killing processes using a specific port.

Installation

Run it directly with npx:

npx @rusky/port-killer --port 3000

Or install it globally:

npm install -g @rusky/port-killer

Usage

Check a port

port-killer --port 3000

If a process is using the port:

Port 3000 is being used by:

PID: 18472
Process: node

Kill process? (y/N)

Automatically kill the process

Use --yes or -y to skip confirmation:

port-killer --port 3000 --yes

port-killer --port 3000 -y

Output:

Port 3000 is being used by:

PID: 18472
Process: node

Killing process 18472...
✓ Process 18472 killed
✓ Port 3000 is now available

Available options

| Option | Description | | --------------- | ------------------------------------- | | --port <port> | Port to inspect | | -y, --yes | Kill the process without confirmation | | -h, --help | Show help | | -V, --version | Show version |

Supported Platforms

• Linux
• Windows

Development

Clone the repository and install dependencies:

git clone https://github.com/ruskydev/port-killer.git
cd port-killer
npm install

Run in development:

npm run dev -- --port 3000

Build:

npm run build

Run the compiled version:

npm start -- --port 3000