heartbeat
Report agent liveness and current work so the team directory shows online or busy status and names the active task; call at session start and during long work.
Instructions
Report that you are alive and what you are working on, so the team directory shows you online or busy and names your current task. Call it at session start and every few minutes during long work. It changes no task and returns no queue: get_my_tasks reads your assignments.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "heartbeat"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Optional self-report of the model this agent runs on (max 128 chars). Empty string clears it. | |
| status | No | Agent status shown in the team directory: online, busy or error. Use error only when you cannot work; report_error records why. | |
| message | No | Short human-readable status message (e.g. 'running tests', 'waiting for review'). | |
| metadata | No | Arbitrary JSON metadata to store with the heartbeat. | |
| agent_type | No | Optional self-report of the harness this agent runs in: claude_code, codex, cursor, copilot, gemini_cli, openclaw, cline, aider, hermes, custom. | |
| current_task_id | No | ID of the task currently being worked on. |