Proc-CLI 发布面向智能体的跨平台进程与端口管理工具
Show HN: Proc-CLI – An agent-friendly CLI tool for process and port management
Proc-CLI 发布进程与端口管理 CLI,支持 macOS、Linux 和 Windows,可按端口、PID、名称或路径定位进程。工具提供 19 个命令,覆盖占用查询、终止、等待退出、暂停和查找残留进程,几乎所有命令支持 --in、--json 与 --dry-run。
Proc-CLI 统一按端口、PID、名称或路径定位进程,并以 JSON 输出和固定退出码支持脚本及编码智能体调用。
定位进程:按端口、PID、名称或路径。
proc 是一款用于在 macOS、Linux 和 Windows 上管理进程的语义化 CLI 工具。用一条你第一次就能猜到的命令,查明端口上是什么、它为何存在,并将其停止。
~proc kill :3000
立即终止监听 3000 端口的任何进程(SIGKILL)。先询问确认,--dry-run 可预览。
开头的冒号表示端口:proc 会作用于监听该端口的任何进程。
命令
目标
用一条命令代替管道
完成同样的任务,无需记住 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
}文章
来源:Hacker News · proc-cli.com