The Matrix has your ports. Every developer has seen EADDRINUSE. You Google it. You run lsof. You copy the PID. You run kill. Every. Single. Time.

Take the red pill. See the truth. Free your ports. One command.

Install

npm i -g redpill

Or run directly — no install needed:

npx redpill 3000

Wake Up, Neo...

See the truth about a port

redpill 3000

  💊 redpill 3000

  PID   2847
  Name  node
  Cmd   next dev
  User  neo

  Kill this process? (y/n)

Free your port — no questions asked

redpill free 3000

"There is no spoon." There is no port conflict. Just free it.

Free an entire range

redpill free 3000-3010

"I know Kung Fu." — You, after freeing 10 ports in one command.

See all listening ports

redpill list
# or
redpill ls

  💊 redpill ls

  PORT    PID       NAME            COMMAND
  ────────────────────────────────────────────────────────────
  3000    2847      node            next dev
  5432    1203      postgres        /usr/lib/postgresql/14/bin/…
  8080    3891      node            vite

  3 ports in use

"I can only show you the door. You're the one that has to walk through it."

Help

redpill --help

Why?

You've been living in the blue pill world:

Error: listen EADDRINUSE: address already in use :::3000

# The blue pill way (every single time)
lsof -i :3000
# scroll through output...
kill -9 2847
# pray it worked...

Take the red pill:

# The red pill way
redpill 3000
# → node (PID 2847) - next dev
# → Kill? y
# ✓ Done.

"Welcome to the real world."

Platforms

Works on macOS and Linux (uses lsof under the hood).

"Unfortunately, no one can be told what the Matrix is. You have to see it for yourself."

Run redpill ls and see.

License

MIT