bot-heartbeat

Monitor background process health and send Telegram or console alerts.

Updated Oct 28, 2022
One-click install
npx skills add https://github.com/patrykk21/dotfiles --skill bot-heartbeat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bot-heartbeat
Source: https://github.com/patrykk21/dotfiles/tree/main/claude/skills/bot-heartbeat
Command: npx skills add https://github.com/patrykk21/dotfiles --skill bot-heartbeat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures the health and operational status of Pilot Bot by running periodic checks and notifying when issues are detected.

Core Features & Use Cases

  • Periodic Health Checks: Spawns a background subagent to run checks at regular intervals.
  • Issue Detection: Evaluates for dead processes, failed jobs, and other potential issues.
  • Notification System: Sends alerts via Telegram or console notifications based on the availability of MCP tools.
  • Use Case: For instance, if the bot process stops running, the Skill will notify the user via Telegram.

Quick Start

Start the bot heartbeat monitoring by running the command: /bot-boot.

Frequently Asked Questions about bot-heartbeat

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

FAQPage Schema
How do I monitor a background process for issues and send automated alerts?

Periodic health checks for background processes involve spawning a subagent to evaluate operational status at regular intervals. This Skill detects dead processes or failed jobs and sends Telegram or console notifications to alert you of issues.

How do I set up bash scripting to check if my bot process is still running?

Setting up bash scripting to check if your bot process is running involves using lock file deduplication to prevent redundant checks. Execute the `/bot-boot` command to initiate the background subagent for periodic process monitoring.

Can I use Telegram notifications for automated health monitoring of my system?

Yes, you can use Telegram notifications for automated health monitoring if MCP tools are available. The system evaluates for dead processes or failed jobs during periodic checks and routes automated alerts directly to Telegram or console.

Does this background health monitoring tool require any external dependencies?

This background health monitoring tool requires no external dependencies to function. It relies entirely on internal bash scripting and lock file deduplication to manage periodic checks and prevent redundant process evaluations.

What is the best way to prevent redundant background process checks in bash?

Preventing redundant background process checks in bash is best achieved through lock file deduplication. This method ensures periodic health checks do not overlap, stopping duplicate monitoring processes from running simultaneously during issue detection.