bgproc

Manage background processes and dev servers with JSON outputs.

23|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/ascorbic/bgproc --skill bgproc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bgproc
Source: https://github.com/ascorbic/bgproc/tree/main
Command: npx skills add https://github.com/ascorbic/bgproc --skill bgproc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

bgproc provides a command-line interface to manage long-running background processes (such as dev servers) with structured JSON outputs for automation and monitoring.

Core Features & Use Cases

  • Start, stop, restart, and query status of processes with a registry-backed lifecycle.
  • Detect open ports (including for child processes), wait for port readiness, and expose port information in status outputs.
  • View logs with controlled size and per-process isolation, plus options to tail or follow.

Quick Start

Start a dev server in the background: bgproc start -n devserver -- npm run dev

Frequently Asked Questions about bgproc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage long-running background processes from the command line with JSON output?

You can manage long-running background processes using bgproc, which starts, monitors, restarts, and cleans up dev servers while outputting structured JSON for automation. It persists state in a local registry within your home folder.

How do I detect open ports for dev servers and child processes in the background?

Port detection for dev servers and their child processes is handled automatically using lsof. The tool waits for port readiness and exposes the detected port information within its structured JSON status outputs.

Can I start a dev server in the background and monitor its lifecycle automatically?

Yes, you can start a dev server in the background and monitor its lifecycle. The tool uses a registry to persist state, allowing you to start, stop, query status, and safely terminate processes across multiple commands.

How do I view and tail logs for background processes without conflicts?

You can view background process logs with per-process isolation and controlled size limits. The tool provides options to tail or follow logs directly from the command line, ensuring clean output for automation.

What is the best way to enforce timeouts and safe termination for background CLI processes?

Enforcing timeouts and safe termination for background CLI processes is built into the tool's core logic. It validates commands, enforces timeout limits, and ensures safe cleanup of processes and their descendants upon exit.

Does bgproc work without external dependencies for process management?

Yes, bgproc operates without external dependencies. It relies on a local registry in your home folder to persist state and uses standard system utilities like lsof for port detection, requiring no additional packages.