目标按端口、PID、名称或路径处理。

proc 是一个用于 macOS、Linux 和 Windows 上进程管理的语义化 CLI 工具。一条命令就能查清某个端口上运行着什么、它为什么在那里，并把它停掉——这条命令你第一次就能猜对。

~proc kill:3000

立即终止监听 3000 端口的任何进程（SIGKILL）。会先询问，并--dry-run预览。

开头的冒号表示端口：proc 会对监听该端口的任何进程执行操作。

命令

目标

开发服务器因 3000 端口被占用而无法启动。proc 找到占用该端口的旧 tmux 会话，释放端口，然后清理其他仍在运行的东西。

一条命令，而不是一串管道

完成同样的任务，无需记住需要哪些标志lsof也无需把 PID 通过管道传给kill。

3000 端口上运行着什么？lsof -i :3000 -P -nproc on :3000

它为什么在那里？lsof -i :3000，然后ps -o ppid=沿调用链向上追溯proc why :3000

释放端口lsof -t -i:3000 | xargs kill && sleep 1 && lsof -i:3000proc free :3000

等待其退出while ps aux | grep node | grep -v grep; do sleep 5; doneproc wait node

暂停进程kill -STOP $(pgrep node)proc freeze node

查找残留进程没有标准工具proc orphans --in .

十九条命令，三项任务

每条命令接受相同的目标，并且几乎都支持--in以限定在一个项目内，--json用于脚本，以及--dry-run在任何更改之前。

所有命令和选项

为脚本和编码智能体而打造

每条命令都输出一个 JSON 文档，包含--json，并且退出码始终含义一致。智能体可以像你一样读取 proc，而无需解析表格。

  • 0成功，1错误，2未找到，3权限被拒绝，4无效输入
  • --dry-run只显示将会被触及的内容，别无其他
  • 这个智能体技能教会 Claude Code、Codex、Cursor、Gemini CLI 等何时该使用 proc
❯ proc on :8080 --json | jq '.process | {pid, cwd, uptime_secs}'
{
  "pid": 177,
  "cwd": "/home/dev/code/shop",
  "uptime_secs": 35
}

文章

所有文章