skills.rest
ETdoFresh
ETdoFreshCOMMUNITY
Explore all skills by this author →
GitHub

port-killer

Kills processes listening on network ports across Windows, macOS, and Linux.

1|Updated Feb 6, 2026
Search Tags:#dev server#cross-platform#port#pid#kill process#lsof#netstat
One-click install
npx skills add https://github.com/ETdoFresh/claude-marketplace --skill port-killer-etdofresh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: port-killer
Source: https://github.com/ETdoFresh/claude-marketplace/tree/main/plugins/port-killer/skills/port-killer
Command: npx skills add https://github.com/ETdoFresh/claude-marketplace --skill port-killer-etdofresh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers frequently hit "port already in use" errors when starting servers, and manually hunting down the offending PID with netstat or lsof is tedious and OS-specific. This Skill finds and terminates the process blocking any port using the correct native commands for your platform. ## Core Features & Use Cases - Cross-Platform Port Freeing: Detects Windows (PowerShell or Git Bash), macOS, or Linux and uses the right tool — Get-NetTCPConnection, netstat/taskkill, lsof, or fuser. - Multiple Ports at Once: Processes several ports sequentially (e.g., 3000, 8080, 5432) and reports the result for each. - Clear Reporting: Outputs which PID was killed on which port, and notes ports that were already free. - Use Case: Your dev server fails to start with "EADDRINUSE: port 3000". Ask the assistant to free port 3000, and it finds the stale process and kills it so you can restart immediately. ## Quick Start Kill whatever process is running on port 3000 and port 8080 so I can restart my dev server.

Frequently Asked Questions about port-killer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I kill a process running on a specific port?▼

Provide the port number and the Skill detects your OS, finds the PID listening on that port using native tools like lsof or netstat, and terminates it. It reports the killed PID and port, or tells you the port was already free.

How to fix "port already in use" or EADDRINUSE errors?▼

These errors mean another process is listening on the port your server needs. The Skill locates that process by port and kills it, freeing the port so your server can start. It works for single or multiple ports at once.

Does killing a port work on Windows, macOS, and Linux?▼

Yes. On Windows it uses Get-NetTCPConnection or netstat with taskkill (supporting both PowerShell and Git Bash), on macOS it uses lsof, and on Linux it uses lsof or fuser as a fallback. The OS is detected automatically.

Can I kill multiple ports at the same time?▼

Yes. Provide several ports, such as 3000, 8080, and 5432, and each one is processed sequentially. You get a per-port report showing which PIDs were killed and which ports were already free.

Why does killing a process on a port fail with permission denied?▼

The process may be owned by another user or require elevated privileges. On macOS and Linux, retry with sudo; on Windows, run the terminal as Administrator. The Skill suggests this when a kill fails due to permissions.

Related Skills

Explore More Software Engineering Skills→
gmolikegmolike

port-registry

Diagnose local dev-server port conflicts and compute deterministic port assignments per project and worktree.

Community
Intermediate
YSheldonYSheldon

workflows

Automate management of long-running server processes and background services.

Community
Intermediate
OpenRouterTeamOpenRouterTeam
7

kill-port

Clear occupied local dev service ports and recover stuck Tilt development stacks.

Official
Basic
tim72117tim72117

test_server_management_ubuntu

Identify and terminate processes occupying ports on Ubuntu or Docker.

Community
Intermediate