bg-jobs

Run and manage background shell commands with friendly-name tracking and output capture.

4|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/lirrensi/agent-cli-helpers --skill bg-jobs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bg-jobs
Source: https://github.com/lirrensi/agent-cli-helpers/tree/main/skills/bg-jobs
Command: npx skills add https://github.com/lirrensi/agent-cli-helpers --skill bg-jobs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Run and manage background jobs from the terminal. Use this skill when you want to execute long-running commands in the background, track job status, read job output, or manage multiple concurrent processes. Provides friendly-name tracking and persisted records for auditability.

Core Features & Use Cases

  • Friendly-name tracking, status monitoring, and output capture for background tasks.
  • Manage multiple concurrent jobs with start, wait, read, and remove operations.
  • Cross-platform compatibility for Windows, macOS, and Linux shells.

Quick Start

Start a background job with bg run "sleep 60" and then check its status with bg status <friendly-name>.

Frequently Asked Questions about bg-jobs

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

FAQPage Schema
How do I run and manage background tasks from the terminal?

To run and manage background tasks from the terminal, start a command using a designated background execution interface, which assigns it a friendly name and captures its output. This lets you execute long-running shell commands concurrently while monitoring their status without blocking your active terminal session.

How do I track the status and read the output of a background process?

You track the status and read the output of a background process by using dedicated status and read operations on its friendly name. The system persists job metadata and logs, allowing you to monitor concurrent processes and retrieve their captured outputs on demand.

Can I execute multiple long-running shell commands concurrently on different operating systems?

Yes, you can execute multiple long-running shell commands concurrently across Windows, macOS, and Linux. The background job manager satisfies cross-platform shell compatibility, allowing you to manage concurrent tasks seamlessly across different desktop and server environments.

What is the best way to manage background shell jobs without losing output logs?

The best way to manage background shell jobs while retaining output logs is to use a persistent job tracking interface that captures process output and metadata. This approach provides a lightweight mechanism to start, wait, list, and retrieve logs for auditability.

How do I wait for a background terminal process to finish and retrieve its logs?

You wait for a background terminal process to finish and retrieve its logs by using the wait and read operations provided by the job manager. This ensures the long-running process completes before you fetch the captured output associated with its assigned friendly name.

Does running background jobs this way keep persistent records of executed commands?

Yes, running background jobs this way keeps persistent records of executed commands. The system stores friendly-name tracking and job metadata, providing an auditable record of your background execution history and allowing you to retrieve logs later.