bgproc
专为AI智能体设计的后台进程管理器,JSON输出友好。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:bgproc。 它的用途是:专为AI智能体设计的后台进程管理器,JSON输出友好。 完整的 Skill 内容见:https://321skill.com/skills/bgproc/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我启动本地的开发服务器,并确保它在端口3000就绪后再告诉我。”,AI会执行 `bgproc start -n devserver -w -- npm run dev` 命令,该命令会启动服务器,等待端口被检测到,并将包含端口号的JSON结果返回给AI,AI即可据此向你报告服务器已就绪。
介绍
bgproc 是一个专为AI智能体设计的后台进程管理器,旨在解决开发者在命令行中管理长期运行进程(如开发服务器)时的繁琐问题。它通过简洁的命令和标准化的JSON输出,让进程的启动、监控和管理变得清晰可控。
使用方式非常直观,通过简单的命令如 bgproc start -n myserver -- npm run dev 即可启动一个命名进程,并支持等待端口就绪、自动重启、查看日志和状态等操作。所有命令的输出均为结构化JSON,便于AI智能体解析和决策。
这个工具非常适合需要自动化管理后台服务的开发者、运维工程师以及AI智能体开发者。它特别适合集成到AI助手的工作流中,让AI能够可靠地执行、监控和重启开发服务器等任务。
建议在项目文档(如AGENTS.md)中明确使用bgproc的流程,并利用其端口等待和自动清理功能来确保服务状态的可靠性。注意其进程管理基于本地文件系统,不适合分布式环境。
核心特点
与通用进程管理器(如pm2)不同,bgproc专为AI智能体交互设计,所有命令输出均为结构化JSON,便于程序解析;同时内置端口自动检测和等待功能,特别适合用于管理需要等待就绪的开发服务器。
注意事项
不适合用于管理生产环境或需要跨机器管理的分布式服务进程。
常见问题
bgproc和pm2有什么区别?
bgproc更轻量,输出为AI友好的JSON格式,内置端口等待功能,专为AI智能体或自动化脚本管理开发服务器等场景设计。
如何查看一个进程是否在运行?
使用 `bgproc status 进程名` 命令,会返回包含运行状态、PID和端口等信息的JSON。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bgproc/raw/index.md 读取 bgproc 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bgproc/raw/index.md(查看排版版本)