heartbeat-watchdog

Observe WezTerm panes, files, and JSONL logs with periodic heartbeats.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/almazom/agents_slash_skills --skill heartbeat-watchdog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartbeat-watchdog
Source: https://github.com/almazom/agents_slash_skills/tree/main/heartbeat-watchdog
Command: npx skills add https://github.com/almazom/agents_slash_skills --skill heartbeat-watchdog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a global observer CLI to watch WezTerm panes, JSONL session logs, and file changes with periodic heartbeats, runtime logs, status, and simple stop controls.

Core Features & Use Cases

  • Observe live WezTerm panes by id or name.
  • Monitor single files or glob-based file sets for changes and activity.
  • Observe JSONL session logs for Codex/Claude/Pi style workflows.
  • Emit heartbeat logs at fixed intervals and expose status and tail views.
  • Lightweight notification path for optional alerts without embedding transport logic.

Quick Start

Start the heartbeat-watchdog to monitor a WezTerm pane or a file with a chosen interval and count.

Frequently Asked Questions about heartbeat-watchdog

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

FAQPage Schema
How do I monitor WezTerm panes for activity with periodic heartbeats?

You can monitor WezTerm panes by referencing their id or name to trigger periodic heartbeats and runtime logs. The observer tracks live pane activity and emits status updates at fixed polling intervals without embedding transport logic.

Can I watch JSONL session logs for Codex or Claude workflows?

Yes, you can observe JSONL session logs generated by Codex, Claude, or Pi style workflows. The watchdog tails these logs and emits heartbeat intervals to track ongoing session activity and status changes.

What is the best way to monitor file changes across a glob-based file set?

Monitoring glob-based file sets involves applying the observer to a file pattern to track changes and activity. The watchdog emits periodic heartbeat logs and exposes tail views for the matched files at your chosen fixed interval.

Does the heartbeat watchdog support multiple source mappings simultaneously?

Yes, the observer supports multiple source mappings, allowing you to monitor WezTerm panes, single files, glob-based sets, and JSONL logs concurrently. Each source runs with fixed-interval polling and optional lightweight notifications.

How do I stop a running file monitoring session and view its runtime logs?

You can use the watchdog's simple stop controls to halt the observation session. It exposes runtime logs, status views, and tail outputs so you can review the captured activity before terminating the heartbeat polling.

Can I send notifications when a monitored log changes without writing custom transport logic?

Yes, the watchdog provides a lightweight notification path for optional alerts. It handles the observation and heartbeat emission while keeping the transport logic external, so you receive status updates without modifying the core observer.