Schedule
TinyAGI/tinyagi
Create, list, and delete scheduled tasks (recurring or one-time) that send messages to agents.
Your heartbeat cron has fired and you need to update your status so the dashboard shows you as alive.
Install Heartbeat
$ npx skills add grandamenium/cortextos --skill heartbeat -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install grandamenium/cortextos 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/grandamenium/cortextos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/community/skills/heartbeat .claude/skills/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 "heartbeat" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/heartbeat into .claude/skills/heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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/grandamenium/cortextos/tree/main/community/skills/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 grandamenium/cortextos --skill heartbeat -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install grandamenium/cortextos heartbeat --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .agents/skills && cp -r skills-src/community/skills/heartbeat .agents/skills/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 "heartbeat" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/heartbeat into .agents/skills/heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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 grandamenium/cortextos --skill heartbeat -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install grandamenium/cortextos heartbeat --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/community/skills/heartbeat .cursor/skills/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 "heartbeat" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/heartbeat into .cursor/skills/heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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/grandamenium/cortextos.git --path community/skills/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 grandamenium/cortextos --skill heartbeat -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install grandamenium/cortextos heartbeat --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/community/skills/heartbeat .gemini/skills/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 "heartbeat" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/heartbeat into .gemini/skills/heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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 grandamenium/cortextos 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 grandamenium/cortextos --skill heartbeat -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .github/skills && cp -r skills-src/community/skills/heartbeat .github/skills/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 "heartbeat" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/heartbeat into .github/skills/heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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 grandamenium/cortextos --skill 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 grandamenium/cortextos heartbeat --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/community/skills/heartbeat .opencode/skills/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 "heartbeat" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/heartbeat into .opencode/skills/heartbeat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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
heartbeat- GitHub stars
- 101
- Token cost
- ~766 tokens
- SKILL.md length
- 158 words
- Files
- 1
- Skills in repo
- 55
- Repo updated
- First seen
- Licence
- MIT
At a glance
Your heartbeat cron has fired and you need to update your status so the dashboard shows you as alive.
- Tasks that involve Scheduled and recurring tasks
- SKILL.md covers Your Heartbeat Cron, Updating Heartbeat, Reading Fleet Heartbeats and Checking a Specific Agent, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Heartbeat is an agent skill from grandamenium/cortextos. Your heartbeat cron has fired and you need to update your status so the dashboard shows you as alive. Or you are checking whether another agent is responsive before sending them work. Or an agent appears offline or stale in the dashboard and you need to investigate whether their session is still running. A dead heartbeat means the system thinks you are down — update it proactively and check fleet health on every heartbeat cycle.
Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Productivity & Automation, covering Scheduled and recurring tasks. The licence is MIT.
When your agent uses it
- Tasks that involve Scheduled and recurring tasks
Example prompts
- “/heartbeat”
What it can do on your machine
Read from SKILL.md and the folder at commit 6f93838. 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 bash and json).
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
Heartbeat loads about 766 tokens when it runs. Until then it costs about 111 tokens; SKILL.md has 158 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 grandamenium/cortextos at commit 6f93838, republished under its MIT licence (© grandamenium). 158 words, ~766 tokens.
Download SKILL.mdSave it as
.claude/skills/heartbeat/SKILL.md (or your agent's skills folder).- name
- heartbeat
- description
- Your heartbeat cron has fired and you need to update your status so the dashboard shows you as alive. Or you are checking whether another agent is responsive before sending them work. Or an agent appears offline or stale in the dashboard and you need to investigate whether their session is still running. A dead heartbeat means the system thinks you are down — update it proactively and check fleet health on every heartbeat cycle.
- triggers
- heartbeat, update heartbeat, check health, agent health, fleet health, agent status, is agent alive, agent offline, agent stale, read heartbeats, heartbeat…
Heartbeat
The heartbeat is how the dashboard and other agents know you are alive. If you stop updating it, you appear DEAD.
Your Heartbeat Cron
Your heartbeat cron is daemon-managed (default every 4h). It lives in ${CTX_ROOT}/state/${CTX_AGENT_NAME}/crons.json and fires even after restarts — no manual restoration needed. When it fires:
# 1. Update your heartbeat with what you're doing
cortextos bus update-heartbeat "WORKING ON: <current task summary>"
# 2. Check inbox for messages
cortextos bus check-inbox
# 3. Log heartbeat event
cortextos bus log-event heartbeat agent_heartbeat info \
--meta "{\"agent\":\"$CTX_AGENT_NAME\",\"status\":\"active\"}"
# 4. Check your task queue for anything stale
cortextos bus list-tasks --agent $CTX_AGENT_NAME --status in_progressUpdating Heartbeat
cortextos bus update-heartbeat "<one sentence: what you are doing right now>"Call this:
- On every heartbeat cron fire
- On session start (before sending online notification)
- When starting a new significant task
- Before going into a long-running operation
Never claim a status you haven't verified. To confirm your crons are active: cortextos bus list-crons $CTX_AGENT_NAME (shows each cron's next_fire_at). Crons are daemon-managed and survive restarts — if a cron is missing, add it via cortextos bus add-cron.
Reading Fleet Heartbeats
# All agents in the org
cortextos bus read-all-heartbeats
# JSON format for parsing
cortextos bus read-all-heartbeats --format jsonReturns: agent name, status, last update timestamp, current task.
Stale threshold: An agent that hasn't updated in >6h should be investigated. Check their status via cortextos status or their heartbeat file.
Checking a Specific Agent
# Read their heartbeat file directly
cat "$CTX_ROOT/state/<agent-name>/heartbeat.json"
# Check agent status via daemon
cortextos status
# Check PM2 process status
pm2 listHeartbeat File Schema
{
"agent": "agent-name",
"status": "active | idle | crashed",
"timestamp": "2026-04-01T12:00:00Z",
"current_task": "What I'm doing right now"
}Location: $CTX_ROOT/state/{agent}/heartbeat.json
© grandamenium, 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 community/skills/heartbeat of grandamenium/cortextos.
Open the folder on GitHubat commit 6f93838
Compare with similar skills
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 |
|---|---|---|---|---|---|---|
| Heartbeat this skillgrandamenium/cortextos | 101 | — | ~766 | Automated safety check: Pass | MIT | |
| ScheduleTinyAGI/tinyagi | 3.6k | — | ~1.4k | Automated safety check: Pass | MIT | |
| Send User MessageTinyAGI/tinyagi | 3.6k | — | ~829 | Automated safety check: Pass | MIT | |
| Cron Opsczl9707/build-your-own-openclaw | 1.9k | — | ~593 | Automated safety check: Pass | MIT | |
| X Bookmarkssharbelxyz/x-bookmarks | 289 | — | ~2k | Automated safety check: Notes | None | |
| Wp Wpcli And OpsAutomattic/agent-skills | 211 | 2 repos | ~988 | Automated safety check: Pass | None |
Similar skills
Send User Message
TinyAGI/tinyagi
Send a proactive message to a paired user via their channel (Discord, Telegram, or WhatsApp).
Cron Ops
czl9707/build-your-own-openclaw
Create, list, and delete scheduled cron jobs. An agent skill from czl9707/build-your-own-openclaw.
X Bookmarks
sharbelxyz/x-bookmarks
Fetch, summarize, and manage X/Twitter bookmarks via bird CLI or X API v2.
Wp Wpcli And Ops
Automattic/agent-skills
A skill your agent uses when working with WP-CLI (wp) for WordPress operations: safe search-replace, db export/import, plugin/theme/user/content management, cron, cache flushing, multisite, and…
Ohdear
ohdearapp/ohdear-cli
Manage Oh Dear website monitoring using the ohdear CLI. An agent skill from ohdearapp/ohdear-cli.
More from grandamenium/cortextos
All 55 skills in this repoCortext Self Diagnosis
grandamenium/cortextos
Diagnose cortextOS itself when the framework misbehaves — an agent has gone silent or wedged, agents are crash-looping, Telegram or agent-to-agent messages are not arriving, crons did not fire, an…
Activity Channel
grandamenium/cortextos
You have completed something significant and want the whole org — all agents and the user — to know about it.
Agentcard Purchase
grandamenium/cortextos
You need to make a purchase on behalf of the user — buy a SaaS subscription, pay for an API, purchase a domain, or any transaction requiring a credit card.
Claude To Codex Migration
grandamenium/cortextos
Migrate ANY cortextOS agent from the claude-code runtime to the live codex-app-server runtime.
Bus Reference
grandamenium/cortextos
Complete cortextos bus CLI reference - all available commands with examples.
Business News Monitor
grandamenium/cortextos
Daily cron-driven scan of news/forums/social in a domain to surface market shifts, new competitors, regulatory changes, and net-new opportunities.
Related
Categories
Questions about Heartbeat
What does Heartbeat do?
Your heartbeat cron has fired and you need to update your status so the dashboard shows you as alive. Heartbeat is an agent skill from grandamenium/cortextos. Your heartbeat cron has fired and you need to update your status so the dashboard shows you as alive.
When should I use Heartbeat?
Heartbeat fits situations like: tasks that involve Scheduled and recurring tasks.
How do I install Heartbeat in Claude Code?
Run `npx skills add grandamenium/cortextos --skill heartbeat -a claude-code`. Or copy the skill folder (community/skills/heartbeat in grandamenium/cortextos) into .claude/skills/heartbeat in your project. Claude Code loads it when a task matches its description.
How do I install Heartbeat in Codex?
Run `npx skills add grandamenium/cortextos --skill heartbeat -a codex`. Or copy the skill folder (community/skills/heartbeat in grandamenium/cortextos) into .agents/skills/heartbeat in your project. Codex loads it when a task matches its description.
Can I use 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 grandamenium/cortextos --skill 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/heartbeat, .gemini/skills/heartbeat, .github/skills/heartbeat and .opencode/skills/heartbeat in your project.
What does Heartbeat need to run?
SKILL.md names no scripts, command-line tools or credentials: Heartbeat is instructions for the agent only.
Does 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 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 Heartbeat use?
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 Heartbeat use?
About 766 tokens (SKILL.md is roughly 3.1k 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 Heartbeat?
Skills that share tags, products or a category with Heartbeat: Schedule (TinyAGI/tinyagi, 3.6k stars), Send User Message (TinyAGI/tinyagi, 3.6k stars), Cron Ops (czl9707/build-your-own-openclaw, 1.9k stars) and X Bookmarks (sharbelxyz/x-bookmarks, 289 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Heartbeat?
grandamenium (a GitHub user) maintains it in grandamenium/cortextos, which has 101 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on September 23, 2026.
Source: grandamenium/cortextos on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.