How this command is triggered — by the user, by Claude, or both
Slash command
/superclaw:sc-heartbeatThis command is limited to the following tools:
The summary Claude sees in its command listing — used to decide when to auto-load this command
# /sc-heartbeat - Quick Heartbeat Report Run all enabled collectors and display a compact system health report. ## Activation Triggered by: `/sc-heartbeat`, "heartbeat", "system health", "how is the system", "quick check" ## Steps 1. **Run system collector**: Gather core system metrics via Bash: Format into metrics: - CPU: usage percentage and load average - Memory: used/total and pressure level - Disk: used/total and percentage 2. **Run dev collector**: Check development environment health: 3. **Check thresholds**: Compare metrics against default thresholds: ...
Run all enabled collectors and display a compact system health report.
Triggered by: /sc-heartbeat, "heartbeat", "system health", "how is the system", "quick check"
Run system collector: Gather core system metrics via Bash:
# CPU usage
top -l 1 -n 0 | grep "CPU usage"
# Memory usage
memory_pressure | head -1
# or: vm_stat | head -5
# Disk usage
df -h / | tail -1
Format into metrics:
Run dev collector: Check development environment health:
# Git status of current project
git -C ~/superclaw status --short | wc -l
# Node.js processes
pgrep -c node
# Recent build status (check if bridge files are fresh)
ls -la ~/superclaw/bridge/*.cjs 2>/dev/null | awk '{print $6, $7, $8, $9}'
Check thresholds: Compare metrics against default thresholds:
| Metric | Warning | Critical |
|---|---|---|
| CPU | > 70% | > 90% |
| Memory | > 75% | > 90% |
| Disk | > 80% | > 95% |
Flag any metrics that exceed thresholds.
Save heartbeat: Write the report to ~/superclaw/data/heartbeats/ with a timestamped filename:
~/superclaw/data/heartbeats/heartbeat-2026-02-12T10-30-00.json
Format compact report: Display results in a concise format:
Heartbeat Report - 2026-02-12 10:30:00
----------------------------------------
CPU: 23% (load: 2.1, 1.8, 1.5) OK
Memory: 12.4/16 GB (78%) WARN
Disk: 180/500 GB (36%) OK
----------------------------------------
Processes: 4 node | Git: 2 changes
Bridges: 3/3 built (12 min ago)
----------------------------------------
Alerts: 1 warning (memory > 75%)
Alert if critical: If any metric exceeds the critical threshold, send an alert to Telegram (if configured):
sc_send_message({
channel: "telegram",
message: "CRITICAL: Memory at 92% on MacBook"
})
npx claudepluginhub jaminitachi/superclaw --plugin superclaw/statusShows heartbeat daemon status: process liveness via PID check, countdowns to next heartbeat/jobs, current settings, and scheduled jobs list.
/doctorDiagnoses babysitter run health (optional run-id uses most recent), checking 10 areas: journal integrity, state cache, effects, locks, sessions, logs, disk usage, and more. Produces structured report with PASS/WARN/FAIL statuses.
/healthRuns the Self-Star Doctor diagnostic, producing a green/yellow/red health board across 7 system junctions (delegation, fitness, autoevolve, steward, verifier-spine, security, kairn-link).