bgrun

Manage and monitor long-running processes and Docker containers via a Bun-based tool.

5|2|Updated Mar 15, 2025
One-click install
npx skills add https://github.com/7flash/bgrun --skill bgrun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bgrun
Source: https://github.com/7flash/bgrun/tree/main
Command: npx skills add https://github.com/7flash/bgrun --skill bgrun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

bgrun helps developers manage and monitor long-running processes and Docker containers from a single Bun-based tool, providing a built-in web dashboard and programmatic API.

Core Features & Use Cases

  • Web dashboard for real-time process management, log viewing, and port visibility.
  • TOML config support and SQLite persistence for reliable deployments.
  • Docker-aware lifecycle handling and a unified CLI workflow for running, stopping, and restarting processes.

Quick Start

Install globally with bun install -g bgrun and start a process with bgrun --name my-app --command "bun run server.ts" and open the dashboard with bgrun --dashboard

Frequently Asked Questions about bgrun

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

FAQPage Schema
How do I manage long-running Bun processes with a web dashboard?

You can manage long-running Bun processes with a web dashboard by installing a process manager globally and using its built-in dashboard to view real-time logs, ports, and process states. It provides a unified CLI to run and monitor apps.

What's the best way to run and monitor Docker containers alongside Bun applications?

Running and monitoring Docker containers alongside Bun applications is best handled by a Docker-aware process manager. It provides deterministic restarts, port detection, and a unified CLI workflow to seamlessly manage both containers and apps from one tool.

Does this Bun process manager support TOML config and SQLite persistence?

Yes, this Bun process manager supports TOML config and SQLite persistence. It uses TOML files for configuration and SQLite for reliable state persistence, ensuring deterministic restarts and reliable deployments across server reboots.

How do I start a process and access the dashboard using bgrun?

To start a process and access the dashboard using bgrun, install it globally with bun install -g bgrun, run a command with bgrun --name my-app --command "bun run server.ts", and open the visual interface with bgrun --dashboard.

Can I integrate process management into my own application via an API?

Yes, you can integrate process management into your application via its server-backed programmatic API. This allows you to programmatically control process lifecycles, trigger restarts, and query port visibility directly from your codebase.

What is deterministic process restart and how does it handle port detection?

Deterministic process restart ensures long-running apps and containers automatically recover to a known state after failures. Port detection automatically identifies available network ports during startup, preventing conflicts when running multiple processes simultaneously.