Claw Heartbeat Delegation
Productivityclaw-heartbeat-delegationClaw Heartbeat Delegation is an Agent Skill for productivity published in the x-cmd/x-cmd repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Task delegation to the heartbeat agent via HEARTBEAT.md. Use when scheduling follow-ups, recurring checks, or recording background jobs for later monitoring.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/x-cmd/x-cmd/blob/HEAD/mod/claw/lib/data/workspace/manager/skills/heartbeat-delegation/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/claw-heartbeat-delegation, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Heartbeat Delegation
Overview
HEARTBEAT.md is your delegation form to the heartbeat agent. Write clearly what needs to be done and when. The heartbeat agent reads and processes it during idle periods.
- One-time tasks (
## In Progress): After execution, the heartbeat agent marks them completed or removes them. - Recurring tasks (
## Recurring): After execution, the heartbeat agent records the run in its ownmemory/state.ymlbut keeps the task inHEARTBEAT.mdfor future runs.
Important: Do NOT execute items in
HEARTBEAT.mdyourself during the current session. Your role is to read it for awareness of pending follow-ups, but execution is the heartbeat agent's responsibility. If a user asks about aHEARTBEAT.mditem, briefly summarize its status; only perform the action if the user explicitly says "do it now" or similar.
Format Reference
One-time follow-up
Write under ## In Progress:
- **Follow-up**: `<task-id>`
- **Due**: YYYY-MM-DD HH:MM
- **Task**: <description>
Recurring check
Write under ## Recurring:
- **Recurring**: `<task-id>`
- **Frequency**: <hourly | daily | weekly>
- **Task**: <description>
Background Job record
When you create a background job via x agent run, also record it in HEARTBEAT.md under ## In Progress:
- **Background Job**: `<job-id>`
- **Display Name**: <friendly name>
- **IM**: <im>
- **Chat ID**: <chatid>
- **Task**: <brief description>
- **Created**: <timestamp>
- **Check command**: `x agent job status --job-id <job-id> --llms`
- **Notify command**: `x claw agentrequest <im> <chatid> '<summary>'`
Checking Completion
The heartbeat agent periodically checks active background jobs:
- Run:
x agent job status --job-id "<id>" --llms - Read the output to determine if the job is done, failed, or still running
- When done, report the summary to the user directly via stdout in the next session, or send a notification to the relevant platform if appropriate