portkill 🔪🩸

                  _   _    _ _ _
  _ __   ___  _ _| |_| | _(_) | |
 | '_ \ / _ \| '_|  _| |/ / | | |
 | |_) | (_) | | | |_|   <| | | |
 | .__/ \___/|_|  \__|_|\_\_|_|_|
 |_|                             

portkill — kill processes on ports, fast.

https://github.com/user-attachments/assets/3ba50634-ed24-4ed3-b1fa-231dfcf8017f

Why portkill?

Because lsof -i :3000 -t | xargs kill -9 is too long to type.

# Before
lsof -i :3000 -t | xargs kill -9

# After
portkill 3000

Installation

Cargo (Recommended)

cargo install portkill

Homebrew

brew tap jofftiquez/tap
brew install portkill

From Source

git clone https://github.com/jofftiquez/pk.git
cd pk
cargo install --path .

Usage

Interactive mode (default)

Run without arguments to see all listening ports and select which to kill:

$ portkill
  PORT      PID  PROCESS          COMMAND
------------------------------------------------------------
○  3000    12345  node             node server.js
○  5432    12346  postgres         /usr/local/opt/postgresql...
○  8080    12347  python           python -m http.server 8080

# Use ↑↓ to navigate, Space to select, Enter to confirm

Filter ports

Use -s to filter by process name, command, or port:

$ portkill -s node
  PORT      PID  PROCESS          COMMAND
------------------------------------------------------------
○  3000    12345  node             node server.js
○  9000    12348  node             node api.js

Kill a specific port

$ portkill 3000
✓ Killed node (PID 12345) on port 3000

Kill multiple ports

$ portkill 3000 8080 9000
✓ Killed node (PID 12345) on port 3000
✓ Killed python (PID 12346) on port 8080
✗ No process found on port 9000

Dry run (see what would be killed)

$ portkill -n 3000
~ Would kill node (PID 12345) on port 3000

Force kill (SIGKILL instead of SIGTERM)

$ portkill -f 3000
✓ Killed node (PID 12345) on port 3000

Options

Comparison

Platform Support

• macOS (Intel + Apple Silicon)
• Linux (x64 + ARM)

License

MIT