bg-jobs 用于在终端后台运行并管理长时间命令。安装后可先运行 bg --help 检查;未安装时执行 uv tool install "git+https://github.com/lirrensi/agent-sommelier"。该 CLI 安装 bg 与 bgj 两个入口:bg 与 POSIX shell 内建同名冲突,在 bash/zsh/fish 中建议使用 bgj,PowerShell/cmd 中可直接用 bg。
主要能力:bg run "命令" 创建后台任务并返回友好名称;bg run --cwd 目录 "命令" 指定工作目录并记录;bg list 查看运行中任务,bg list --all 包含已结束任务,支持 --page 和 --json;bg status <名称或UID> 查看 JSON 状态,运行中任务可能含耗时、内存、CPU,结束后可能含 finished_at 与 exit_code;bg read 读取完整 stdout,--tail 只读新增输出;bg logs 合并 stdout 与 stderr;bg wait 等待单个任务,--match 等待匹配输出,bg wait-all 等待全部;bg rm 删除任务,bg prune 清理非运行任务,bg restart 重启任务并保留 UID 与名称。
等待机制:非 TTY(代理/脚本)模式默认 120 秒上限,TTY 交互模式无限等待。用 --timeout N 覆盖,--timeout 0 取消上限。超时时会向 stderr 输出说明并以退出码 0 结束,代理应读取 stderr 判断超时,并可通过 bg status、bg wait --timeout 300、bg wait --timeout 0、bg logs 重新轮询。
状态值包括 running、launching、completed、failed、stale 及 missing/corrupt/orphaned。任务状态保存在系统临时目录 agentcli_bgjobs/ 下,含 index.json、meta.json、stdout.txt、stderr.txt、exit_code.txt。已结束任务至少保留 1 小时、最多 32 个,运行中任务不会被自动清理。Windows 下优先 PowerShell 7、Windows PowerShell,再 cmd.exe,后台任务隐藏启动;如需 cmd 语法可用显式 cmd.exe /d /c "..."。资料未提供该技能的授权、收费与平台兼容性之外的更多信息。