ai-port-doctor

Diagnose and fix port conflicts instantly. Find what's using a port and kill it.

Install

npx ai-port-doctor

What it does

• Check what's running on any port
• Kill processes blocking your ports
• List all listening ports
• Find free ports for development
• Works on macOS, Linux, and Windows

Usage

# Check common dev ports (3000, 5173, 8080, etc.)
npx ai-port-doctor

# Check specific port
npx ai-port-doctor 3000

# Check multiple ports
npx ai-port-doctor 3000,5000,8080

# Kill process on port
npx ai-port-doctor 3000 -k

# Force kill (no confirmation)
npx ai-port-doctor 3000 -k -f

# List all listening ports
npx ai-port-doctor --list

# Find free ports
npx ai-port-doctor --suggest

# Find free port in range
npx ai-port-doctor --range 8000-9000

Example Output

🩺 Port Doctor

Checking common development ports...

  ● 3000   node (PID 12345) React/Node Dev
  ● 5173   vite (PID 23456) Vite
  ○ 4000   Free GraphQL/Phoenix
  ○ 5000   Free Flask/ASP.NET
  ○ 8000   Free Django/Python
  ○ 8080   Free Alt HTTP/Tomcat

Tip: ai-port-doctor 3000 -k  # kill process on port 3000

Kill Mode

$ npx ai-port-doctor 3000 -k

🩺 Port Doctor

🔍 Port 3000 (React/Node Dev)

  ● node (PID: 12345)
    User: yourname
    Connection: *:3000

? Kill 1 process(es) on port 3000? (y/N) y
  ✓ Killed node (PID 12345)

Options

| Flag | Description | |------|-------------| | -k, --kill | Kill processes on the port | | -f, --force | Force kill without confirmation | | -l, --list | List all listening ports | | -s, --suggest | Suggest free ports | | -r, --range <range> | Find free port in range |

Common Ports Reference

| Port | Typical Use | |------|-------------| | 3000 | React, Node.js dev servers | | 4000 | GraphQL, Phoenix | | 5000 | Flask, ASP.NET Core | | 5173 | Vite | | 5432 | PostgreSQL | | 6379 | Redis | | 8000 | Django, Python HTTP | | 8080 | Tomcat, alt HTTP | | 27017 | MongoDB |

License

MIT

Built by LXGIC Studios 🔗 GitHub · Twitter 💡 Want more free tools like this? We have 100+ on our GitHub: github.com/lxgicstudios