watchdog

Detect stalled pipeline executions and trigger /hw:resume via cron.

24|3|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/HypoxanthineOvO/Hypo-Workflow --skill watchdog-hypoxanthineovo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: watchdog
Source: https://github.com/HypoxanthineOvO/Hypo-Workflow/tree/main/skills/watchdog
Command: npx skills add https://github.com/HypoxanthineOvO/Hypo-Workflow --skill watchdog-hypoxanthineovo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This internal watchdog monitors pipeline state and heartbeat signals to automatically trigger a resume when execution stalls, ensuring progress without manual intervention.

Core Features & Use Cases

  • Monitors .pipeline/state.yaml and .pipeline/config.yaml to determine when to resume.
  • Manages a lockfile to prevent concurrent resumes and avoid race conditions.
  • Registers and unregisters a cron job to drive periodic checks.

Quick Start

Configure .pipeline/config.yaml to enable watchdog and ensure cron is running so the watchdog periodically resumes stalled pipelines.

Frequently Asked Questions about watchdog

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

FAQPage Schema
How do I automatically resume a stalled pipeline execution?

To automatically resume a stalled pipeline, configure `.pipeline/config.yaml` to enable the watchdog and ensure cron is running; it reads state, monitors heartbeat and lockfile, then triggers resume to continue progress without manual intervention.

What is a cron watchdog and how does it handle pipeline monitoring?

A cron watchdog is a periodic monitor that reads `.pipeline/state.yaml` and heartbeat signals within a cron-driven loop to detect stalled executions, managing a lockfile to prevent concurrent resumes before triggering a pipeline resume.

How do I prevent race conditions when auto-resuming cron pipelines?

To prevent race conditions when auto-resuming cron pipelines, the watchdog applies safe lock handling by managing a lockfile, ensuring isolation from user data and preventing concurrent resume triggers from overlapping.

Do I need cron to run a pipeline heartbeat monitor?

Yes, you need cron running to use this pipeline heartbeat monitor, because the watchdog registers a cron entry to drive periodic checks of `.pipeline/state.yaml` and handle retries and notifications automatically.

Why does my pipeline stall and how do I log watchdog retries?

Pipelines stall when heartbeat signals fail or execution hangs; the watchdog logs retries and notifications by writing to `.pipeline/watchdog.log` while monitoring `.pipeline/config.yaml` and state files.