Configure Channel
openclaw/openclaw
Configure and prove a chat channel with non-interactive one-liners; secrets only as SecretRefs.
Configure periodic health checks via HEARTBEAT.md and the /heartbeat command.
MITAuto-check passed
Install Pi Heartbeat
$ npx skills add espennilsen/pi --skill pi-heartbeat -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install espennilsen/pi pi-heartbeat --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .claude/skills && cp -r skills-src/extensions/pi-heartbeat/skills/pi-heartbeat .claude/skills/pi-heartbeat && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "pi-heartbeat" agent skill from https://github.com/espennilsen/pi/tree/main/extensions/pi-heartbeat/skills/pi-heartbeat into .claude/skills/pi-heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pi-heartbeat", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/espennilsen/pi/tree/main/extensions/pi-heartbeat/skills/pi-heartbeatType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add espennilsen/pi --skill pi-heartbeat -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install espennilsen/pi pi-heartbeat --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .agents/skills && cp -r skills-src/extensions/pi-heartbeat/skills/pi-heartbeat .agents/skills/pi-heartbeat && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "pi-heartbeat" agent skill from https://github.com/espennilsen/pi/tree/main/extensions/pi-heartbeat/skills/pi-heartbeat into .agents/skills/pi-heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pi-heartbeat", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add espennilsen/pi --skill pi-heartbeat -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install espennilsen/pi pi-heartbeat --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/extensions/pi-heartbeat/skills/pi-heartbeat .cursor/skills/pi-heartbeat && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "pi-heartbeat" agent skill from https://github.com/espennilsen/pi/tree/main/extensions/pi-heartbeat/skills/pi-heartbeat into .cursor/skills/pi-heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pi-heartbeat", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/espennilsen/pi.git --path extensions/pi-heartbeat/skills/pi-heartbeat--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add espennilsen/pi --skill pi-heartbeat -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install espennilsen/pi pi-heartbeat --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/extensions/pi-heartbeat/skills/pi-heartbeat .gemini/skills/pi-heartbeat && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "pi-heartbeat" agent skill from https://github.com/espennilsen/pi/tree/main/extensions/pi-heartbeat/skills/pi-heartbeat into .gemini/skills/pi-heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pi-heartbeat", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install espennilsen/pi pi-heartbeatInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add espennilsen/pi --skill pi-heartbeat -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .github/skills && cp -r skills-src/extensions/pi-heartbeat/skills/pi-heartbeat .github/skills/pi-heartbeat && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "pi-heartbeat" agent skill from https://github.com/espennilsen/pi/tree/main/extensions/pi-heartbeat/skills/pi-heartbeat into .github/skills/pi-heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pi-heartbeat", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add espennilsen/pi --skill pi-heartbeat -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install espennilsen/pi pi-heartbeat --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/extensions/pi-heartbeat/skills/pi-heartbeat .opencode/skills/pi-heartbeat && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "pi-heartbeat" agent skill from https://github.com/espennilsen/pi/tree/main/extensions/pi-heartbeat/skills/pi-heartbeat into .opencode/skills/pi-heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pi-heartbeat", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
pi-heartbeat- GitHub stars
- 122
- Token cost
- ~414 tokens
- SKILL.md length
- 131 words
- Files
- 1
- Skills in repo
- 36
- Repo updated
- First seen
- Licence
- MIT
At a glance
Configure periodic health checks via HEARTBEAT.md and the /heartbeat command.
- Works in 3 steps: Enable via --heartbeat flag, /heartbeat… → Create a HEARTBEAT.md in your project… → If the agent responds with HEARTBEAT_OK,…
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Pi Heartbeat is an agent skill from espennilsen/pi. Configure periodic health checks via HEARTBEAT.md and the /heartbeat command.
Its SKILL.md is about 410 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The licence is MIT.
Example prompts
- “/pi-heartbeat”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Enable via --heartbeat flag, /heartbeat on, or settings.json
- Create a HEARTBEAT.md in your project root with check items
- If the agent responds with HEARTBEAT_OK, the result is suppressed. Any other response is treated as an alert and sent via pi-channels.
What it can do on your machine
Read from SKILL.md and the folder at commit 79d019b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are json and markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Pi Heartbeat loads about 414 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 131 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from espennilsen/pi at commit 79d019b, republished under its MIT licence (© espennilsen). 131 words, ~414 tokens.
Download SKILL.mdSave it as
.claude/skills/pi-heartbeat/SKILL.md (or your agent's skills folder).- name
- pi-heartbeat
- description
- Configure periodic health checks via HEARTBEAT.md and the /heartbeat command.
Pi Heartbeat Extension
Runs a periodic health-check prompt as an isolated subprocess.
Setup
Enable via
--heartbeatflag,/heartbeat on, or settings.json:json { "pi-heartbeat": { "enabled": true, "intervalMinutes": 15 } }Create a
HEARTBEAT.mdin your project root with check items:markdown # Heartbeat Checklist - [ ] Check git status — any uncommitted changes? - [ ] Check disk space — anything over 90%? - [ ] Review td list for blocked tasksIf the agent responds with
HEARTBEAT_OK, the result is suppressed. Any other response is treated as an alert and sent via pi-channels.
Configuration (settings.json)
{
"pi-heartbeat": {
"enabled": false,
"intervalMinutes": 15,
"activeHours": { "start": "08:00", "end": "22:00" },
"route": "ops",
"showOk": false,
"prompt": null
}
}- enabled: Start heartbeat on session start
- intervalMinutes: Check frequency (default: 15)
- activeHours: Only run during these hours (null = always)
- route: pi-channels route for alerts (default: "ops")
- showOk: Also send HEARTBEAT_OK results to the channel
- prompt: Custom prompt (overrides HEARTBEAT.md)
Commands
/heartbeat on— Start periodic checks/heartbeat off— Stop checks/heartbeat status— Show run stats/heartbeat run— Run a check immediately
Events
heartbeat:check— Emitted when a check startsheartbeat:result— Emitted with{ ok, response, durationMs }
© espennilsen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in extensions/pi-heartbeat/skills/pi-heartbeat of espennilsen/pi.
Open the folder on GitHubat commit 79d019b
Compare with similar skills
Pi Heartbeat next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Pi Heartbeat this skillespennilsen/pi | 122 | — | ~414 | Automated safety check: Pass | MIT | |
| Configure Channelopenclaw/openclaw | 392k | — | ~946 | Automated safety check: Pass | MIT | |
| Skin Health Analyzersickn33/agentic-awesome-skills | 47k | 2 repos | ~293 | Automated safety check: Pass | MIT | |
| Codebase Health Dashboardgarrytan/gstack | 136k | — | ~11k | Automated safety check: Notes | MIT | |
| Healthagenticnotetaking/arscontexta | 3.5k | — | ~7.1k | Automated safety check: Notes | MIT | |
| ConfigurationBuilderIO/agent-native | 7.1k | — | ~2.1k | Automated safety check: Pass | None |
Similar skills
Skin Health Analyzer
sickn33/agentic-awesome-skills
Analyze skin health data, identify skin problem patterns, assess skin health status.
Codebase Health Dashboard
garrytan/gstack
Runs a project's own type checker, linter, test runner, dead-code detector and shell linter, combines them into a weighted 0-10 score and tracks the trend.
Health
agenticnotetaking/arscontexta
Run condition-based vault health diagnostics. An agent skill from agenticnotetaking/arscontexta.
Configuration
BuilderIO/agent-native
Where a configuration value belongs — app config schema, agent-native.config.ts, or an environment variable — and how the layers resolve.
Health Wellness
sickn33/agentic-awesome-skills
Wellbeing check-in register: anonymous flag, department, check-in date, wellbeing score, stress and energy levels, support and resource flags, confidentiality and status.
More from espennilsen/pi
All 36 skills in this repoGitHub
espennilsen/pi
Interact with GitHub repos, PRs, issues, CI, and notifications via the pi-github extension commands and gh CLI.
Skill Creator
espennilsen/pi
Create, review, and improve skills for Pi agents. An agent skill from espennilsen/pi.
Dry Code Review
espennilsen/pi
Perform a comprehensive DRY (Don't Repeat Yourself) code review on a codebase.
Extract Design System
espennilsen/pi
Reverse-engineer a design system from a live website (public URL or localhost).
PDF Reader
espennilsen/pi
Read and extract content from PDF files — text, tables, metadata, and images.
Google Workspace
espennilsen/pi
Manage Google Workspace via the gws CLI — Drive, Gmail, Sheets, Docs, Slides, People, Chat, Meet, Forms, and cross-service workflows.
Questions about Pi Heartbeat
What does Pi Heartbeat do?
Configure periodic health checks via HEARTBEAT.md and the /heartbeat command. Pi Heartbeat is an agent skill from espennilsen/pi.md and the /heartbeat command.
How do I install Pi Heartbeat in Claude Code?
Run `npx skills add espennilsen/pi --skill pi-heartbeat -a claude-code`. Or copy the skill folder (extensions/pi-heartbeat/skills/pi-heartbeat in espennilsen/pi) into .claude/skills/pi-heartbeat in your project. Claude Code loads it when a task matches its description.
How do I install Pi Heartbeat in Codex?
Run `npx skills add espennilsen/pi --skill pi-heartbeat -a codex`. Or copy the skill folder (extensions/pi-heartbeat/skills/pi-heartbeat in espennilsen/pi) into .agents/skills/pi-heartbeat in your project. Codex loads it when a task matches its description.
Can I use Pi Heartbeat in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add espennilsen/pi --skill pi-heartbeat -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pi-heartbeat, .gemini/skills/pi-heartbeat, .github/skills/pi-heartbeat and .opencode/skills/pi-heartbeat in your project.
What does Pi Heartbeat need to run?
SKILL.md names no scripts, command-line tools or credentials: Pi Heartbeat is instructions for the agent only.
Does Pi Heartbeat access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Pi Heartbeat safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Pi Heartbeat use?
Pi Heartbeat is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Pi Heartbeat use?
About 414 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Pi Heartbeat?
Skills that share tags, products or a category with Pi Heartbeat: Configure Channel (openclaw/openclaw, 392k stars), Skin Health Analyzer (sickn33/agentic-awesome-skills, 47k stars), Codebase Health Dashboard (garrytan/gstack, 136k stars) and Health (agenticnotetaking/arscontexta, 3.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Pi Heartbeat?
espennilsen (a GitHub user) maintains it in espennilsen/pi, which has 122 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on September 21, 2026.
Source: espennilsen/pi on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.