Port killer

Skill YuAICode/ai-skills/skills/port-killer

35 个即用 Claude Code skill,每个都带离线测试 + skill-doctor 自校验 · 35 tested, self-linted Claude Code skills (中文优先)

Install

npx -y skills add YuAICode/ai-skills --skill port-killer

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

找出占用某端口的进程,列出 PID/命令/用户并给出 kill 命令;默认只查不杀,加 --kill --yes 才真杀。当用户说「X 端口被占了 / 杀掉占 X 端口的进程 / 谁在用 8080 / port killer」时触发。

SKILL.md

2.2 KB, as published. Nobody here has run it

port-killer — 端口占用查杀

找出哪个进程在占用指定 TCP 端口,列出 PID / 命令 / 用户,给出杀进程命令——默认只查不杀,杀之前先让用户确认。

何时触发

"8080 端口被占了"
"谁在用 3000 端口"
"帮我杀掉占 9000 端口的进程"
"port killer"
"kill port X"
"这个端口被占了,启不起来"

工作流

查:跑 whoport.sh <端口>,展示占用该端口的进程信息(PID / 命令 / 用户)。
展示:把结果呈现给用户,同时给出建议的 kill 命令供参考。
确认:若用户说"杀掉它",先复述将要杀的进程,等用户明确同意。
杀:用户确认后,跑 whoport.sh <端口> --kill --yes 执行 SIGTERM。

默认只查,不自动杀。 杀进程是有副作用的操作,必须显式 --kill --yes 且用户已确认。

用法

# 只查(展示占用进程 + 建议命令,不杀)
bash <skill>/bin/whoport.sh 8080

# 查并杀(SIGTERM,需 --yes 二次确认)
bash <skill>/bin/whoport.sh 8080 --kill --yes

输出示例(只查)

端口 8080 被以下进程占用:
  PID    命令           用户
  12345  python3        alice
  12346  uvicorn        alice

建议:kill 12345 12346
顽固进程:kill -9 12345 12346
(本次仅查询,未执行 kill)

输出示例(加 --kill --yes)

将要杀死以下进程(SIGTERM):
  PID    命令           用户
  12345  python3        alice
已执行:kill 12345

环境变量

变量	说明
`LSOF`	覆盖 lsof 二进制路径(默认 `lsof`)

边界

只找 TCP LISTEN 状态(不含 UDP、已建立连接)。
只发 SIGTERM(不自动 -9);顽固进程需用户手动 kill -9。
需要 lsof;没有时脚本给出 ss -ltnp / netstat 替代命令提示并 exit 1。
端口号须为 1-65535 的整数,否则报错并 exit 1。
不修改任何系统配置,只读 lsof 输出 + 发送信号。