Skip to content

dinakars777/port-sniper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

port-sniper 🎯

A blazing fast, beautiful CLI tool to instantly identify and kill processes hoarding your local development ports.

(A beautiful, interactive CLI built with @clack/prompts)

The Problem

Getting the dreaded EADDRINUSE: address already in use :::3000 error happens multiple times a day. You usually have to Google lsof -i :3000, copy the PID, and type kill -9 <PID>.

port-sniper automates this away into a single visually satisfying command.

Features

  • Zero configuration required. Just type snipe <port>.
  • 🎨 Beautiful UI. Powered by @clack/prompts.
  • Lightning Fast. Uses native lsof and kill -9 commands under the hood. No heavy libraries.
  • 🛡️ Interactive Safety. Prompts you before killing anything to ensure you don't accidentally terminate the wrong service.

Usage

Simply run this command:

npx @dinakars777/port-sniper 3000

For the best experience, install it globally so you can use the short snipe alias!

npm install -g @dinakars777/port-sniper

# Now you can just use:
snipe 3000
snipe 8080

How It Works

  1. It searches for processes bound to the provided port number.
  2. If the port is free, it tells you and exits.
  3. If it finds a process, it displays the Command, PID, and User owning the process.
  4. It asks you to confirm Kill this process? [y/N].
  5. If confirmed, it executes a forceful termination and frees up your port!

Contributing

Pull requests are welcome!

git clone https://github.com/dinakars777/port-sniper.git
cd port-sniper
npm install
npm run dev

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors