Open-source AI agent to safely terminate stray localhost processes and free blocked ports.
Works with Node.js, Python/Django/Flask, Java/Spring Boot, Ruby/Rails, Go, PHP and more.

👆 Click to watch the demo video
🎥 https://youtu.be/Fetdo7CfPIs

Every developer knows this pain:

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

You forgot to stop a dev server. Now you're hunting PIDs manually. Not anymore.

/killservers

That's it. ServerSlayer finds and safely kills stray development servers, idle localhost processes, and zombie dev servers — instantly.

git clone https://github.com/supratikpm/ServerSlayer.git

Windows (PowerShell):

Copy-Item -Path "path\to\ServerSlayer\.agent" -Destination ".\" -Recurse -Force

macOS / Linux:

cp -r /path/to/ServerSlayer/.agent ./

Type /listports or /killservers in your AI chat. Done!

ServerSlayer is IDE-agnostic. Tested and works with:

You have access to ServerSlayer workflows in .agent/workflows/.
When the user mentions ports, servers, or "port in use" errors, use:
- /listports - to see what's running
- /killservers - to safely kill dev servers
- /killport <port> - to kill a specific port
- /nukeports - for force kill

Run: python .agent/tools/server_slayer_tools.py [list|kill] [options]

You have ServerSlayer for port management.

Commands:
python .agent/tools/server_slayer_tools.py list
python .agent/tools/server_slayer_tools.py kill --scope=project
python .agent/tools/server_slayer_tools.py kill --force
python .agent/tools/server_slayer_tools.py kill --port 3000

SAFETY: Never kill ports 3306, 5432, 27017, 6379 (databases).

ServerSlayer automatically protects critical services:

The core logic is in server_slayer_tools.py:

# Detection: Find all listening ports
def get_listening_ports():
    if SYSTEM_OS == "Windows":
        output = run_command(["netstat", "-ano"])
        # Parse LISTENING ports...
    else:  # macOS / Linux
        output = run_command(["lsof", "-iTCP", "-sTCP:LISTEN", "-n", "-P"])
        # Parse listening ports...

# Safety: Never kill protected services
PROTECTED_PORTS = [3306, 5432, 27017, 6379, 1433, 22]
PROTECTED_PROCESSES = ["docker", "postgres", "mysql", "ngrok", "vscode", "cursor"]

# Kill: Graceful first, force if needed
def kill_process(pid, force=False):
    if SYSTEM_OS == "Windows":
        subprocess.run(["taskkill", "/PID", str(pid), "/F" if force else ""])
    else:
        subprocess.run(["kill", "-9" if force else "", str(pid)])

Full source: server_slayer_tools.py

.agent/                          # 👈 Copy this folder to any project
├── tools/
│   └── server_slayer_tools.py   # Core detection & kill logic
└── workflows/
    ├── listports.md             # /listports command
    ├── killservers.md           # /killservers command
    ├── killport.md              # /killport command
    └── nukeports.md             # /nukeports command

PRs welcome! See CONTRIBUTING.md

Help needed:

• 🍎 macOS/Linux testing
• 🧩 More framework detection
• 🎬 Better demo GIF

If ServerSlayer saved you from "port already in use" hell:

kill stray servers • port already in use • terminate localhost processes • safe port killer • idle server killer • free blocked ports • dev server cleanup • cursor rules • ai agent • antigravity ide

⚔️ Stray servers slain! Happy coding! 🚀

Made with ⚔️ by @supratikpm