# Heartbeat System

> Periodic health checks and self-monitoring. Runs scheduled diagnostics and reports system status. Inspired by ZeroClaw's HEARTBEAT.md system.

- Skill: `winsorllc/heartbeat-system` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add winsorllc/heartbeat-system`
- Raw SKILL.md: https://api.skillmd.com/api/skills/winsorllc/heartbeat-system/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: winsorllc (https://skillmd.com/u/winsorllc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/winsorllc/heartbeat-system

---


# Heartbeat System

Self-monitoring and periodic health checks for the agent. Similar to ZeroClaw's built-in heartbeat system.

## Capabilities

- Run periodic health checks
- Monitor system resources
- Report status to configured channels
- Track uptime and performance metrics
- Run diagnostics on schedule

## Usage

```bash
# Run heartbeat check
/job/.pi/skills/heartbeat-system/heartbeat.js

# Check heartbeat config
/job/.pi/skills/heartbeat-system/heartbeat-config.js

# View heartbeat history
/job/.pi/skills/heartbeat-system/heartbeat-history.js
```

## Configuration

Heartbeat is configured via `config/HEARTBEAT.md` or environment variables.

```yaml
interval_minutes: 30      # How often to run
enabled: true             # Enable/disable
message: "Health check"   # Default message
target: "log"            # Where to report (log, file)
```

## When to Use

- Monitor long-running agents
- Detect resource issues early
- Track system health over time
- Generate periodic status reports