# Heartbeat

Set recurring checks or completion watches with `sno heartbeat` and its persistent log...

- Repository: https://github.com/sno-ai/sno-station-skills (860 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add sno-ai/sno-station-skills --skill heartbeat -g -a claude-code -y`
Codex: `npx skills add sno-ai/sno-station-skills --skill heartbeat -g -a codex -y`
Cursor: `npx skills add sno-ai/sno-station-skills --skill heartbeat -g -a cursor -y`
Gemini CLI: `npx skills add sno-ai/sno-station-skills --skill heartbeat -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add sno-ai/sno-station-skills`

## Description

Set recurring checks or completion watches with `sno heartbeat` and its persistent log reader. Use for periodic reports or unattended long runs. Not for calendar scheduling or commands watched directly.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# heartbeat

Use the `sno heartbeat` command installed by `sno setup`. This skill supplies
instructions, not a program copy. If the command names a missing prerequisite, install
that tool and retry. On macOS install Homebrew `coreutils` (GNU `timeout`, `tail` and `mv`) and
put its `libexec/gnubin` directory on PATH; newer versions of the command also find the
`g`-prefixed names without it, and then the reader command they print says `gtail`. Install `bash`
and `flock` when required. Windows requires WSL.

[The bundled command contract](references/heartbeat-contract.json) pins the public syntax
checked by this skill's offline self-test. Use `sno heartbeat --help` for the installed program.

Before arming, verify that this harness provides both background execution and a
persistent reader that delivers new output into the agent's conversation. If either is
unsupported or unverified, skip this skill and name the missing capability. The examples
below require those tools and use Claude Code's `Bash` and `Monitor` tool names; other harnesses use
their own equivalents. A background process or a log file alone is insufficient.

The rest: https://github.com/sno-ai/sno-station-skills/blob/HEAD/skills/S-communication-and-handoff/heartbeat/skill/SKILL.md