jb-bgproc

Original：🇺🇸 English
Translated

Manage and inspect background processes for agents using the bgproc CLI. Use when asked to start, stop, list, clean, check status, or view logs for bgproc-managed processes, or when a task needs a JSON-outputting process manager.

12installs
Sourcebjesuiter/skills
Added on

NPX Install

npx skill4agent add bjesuiter/skills jb-bgproc

Tags

Translated version includes tags in frontmatter
bgproc-cliprocess-managementagent-toolsjson-outputbackground-processes

SKILL.md Content

View Translation Comparison →

bgproc CLI

Simple process manager for agents. All commands output JSON to stdout.

Quick usage

bash
bgproc start -n myserver -- npm run dev

Commands

  • start: Start a background process
  • status: Get status of a background process (pid, open ports)
  • logs: View logs for a background process
  • stop: Stop a background process
  • list: List all background processes
  • clean: Remove dead processes and their logs

start

bash
bgproc start -n <name> [-f] [-t <seconds>] [-w [<seconds>]] [--keep] -- <command...>
Notes:
  • -n <name>
    : Name the process (required)
  • -f
    : Force start if name exists
  • -t <seconds>
    : Timeout before considering start failed
  • -w [<seconds>]
    : Wait for the process to become ready; optional seconds
  • --keep
    : Keep logs after stop
  • --
    : Separator before the command to run

Other commands

bash
bgproc status -n <name>
bgproc logs -n <name>
bgproc stop -n <name>
bgproc list
bgproc clean

Tips

  • Parse JSON output to extract pid, ports, and status fields.
  • Use 
    bgproc clean
    to remove stale entries and logs.