heartbeat-monitor

Emit periodic heartbeat signals and detect stalls in long-running tasks.

1|Updated Mar 7, 2026

Search Tags:#monitoring #progress tracking #long-running tasks #heartbeat #stuck process

Ready to run

npx skills add https://github.com/jimmymalhan/codereview-pilot --skill heartbeat-monitor

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: heartbeat-monitor
Source: https://github.com/jimmymalhan/codereview-pilot/tree/main/.claude/skills/heartbeat-monitor
Command: npx skills add https://github.com/jimmymalhan/codereview-pilot --skill heartbeat-monitor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents long-running processes from silently failing or getting stuck by periodically checking for progress and alerting if a process appears to have stalled.

Core Features & Use Cases

Progress Monitoring: Emits regular status updates during extended operations.
Stall Detection: Automatically identifies if a process hasn't made progress within a defined timeout.
Use Case: For complex, multi-phase operations that might take hours, this skill ensures you're notified if one phase gets stuck, allowing for timely intervention.

Quick Start

Use the heartbeat-monitor skill to track progress on a long-running task, alerting if no activity is detected for 15 minutes.

Frequently Asked Questions about heartbeat-monitor

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

FAQPage Schema

How do I detect stuck long-running tasks in complex orchestration flows?▼

You can detect stuck long-running tasks by emitting periodic heartbeat signals and monitoring inactivity thresholds to trigger alerts when a process stalls. This approach tracks last activity timestamps to identify silent failures in complex orchestration flows.

What is the best way to monitor progress for multi-phase operations that might take hours?▼

The best way to monitor progress for multi-phase operations is to emit regular heartbeat status updates and set an inactivity timeout. This ensures you receive alerts if any phase gets stuck, allowing for timely intervention during operations that might take hours.

Does heartbeat monitoring work for iterative processes exceeding ten minutes?▼

Yes, heartbeat monitoring works for iterative processes exceeding ten minutes by tracking last activity timestamps and implementing a timeout mechanism. It is specifically applicable to complex orchestration flows and extended iterative operations that require stall detection.

How do I set up a timeout mechanism to alert when a process hasn't made progress?▼

You set up a timeout mechanism by defining an inactivity threshold, such as alerting if no activity is detected for 15 minutes. The monitor tracks last activity timestamps and automatically triggers alerts and state saving when the threshold is exceeded.

Why does my long-running process silently fail without any alerts?▼

Long-running processes silently fail when they get stuck without periodic progress checking. Implementing heartbeat monitoring prevents this by emitting regular status updates and automatically alerting if no activity is detected within a defined timeout period.