bgproc CLI

Quick usage

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

bgproc start -n <name> [-f] [-t <seconds>] [-w [<seconds>]] [--keep] -- <command...>

• -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

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.