Where is the session heartbeat data stored?

All monitoring data is stored locally in your home directory under ~/.claude/popkit/heartbeats/ for privacy and persistence.

How does the Heartbeat skill detect if Claude is stuck?

It uses a confidence-based scoring system that analyzes indicators like repeated edits to the same file, consecutive bash command failures, and circular edit patterns (A→B→A).

Can I manually record my progress during a session?

Yes, you can use the '/heartbeat beat --progress' command to record a manual heartbeat with a custom note about your current development phase.

Does this skill help with long-running sessions?

Absolutely. It tracks session age and activity, providing a summary of files touched and tool calls made, making it easier to manage multi-hour coding tasks.

Session Heartbeat Monitor

Name: Session Heartbeat Monitor
Author: jrc1883

byjrc1883

Analytics & Monitoring

Monitors Claude Code session health and identifies stuck development patterns to maintain high agent productivity.

About

The Session Heartbeat Monitor is a specialized observability tool for Claude Code that tracks development activity in real-time. It provides deep insights into session health by monitoring tool calls, file modifications, and command success rates. By identifying productivity bottlenecks like circular edit loops or repeated failures, the skill offers recovery recommendations and session persistence, ensuring long-running AI development workflows remain efficient and goal-oriented.

Key Features

0 GitHub stars
Automated tracking of tool calls, duration, and file touchpoints
Intelligent stuck detection for circular edits and command loops
Manual progress markers with descriptive heartbeat recording
Detailed session history and state recovery capabilities
Real-time session health visualization with compact status lines

Use Cases

Resuming long-running development tasks by restoring state from previous sessions
Monitoring progress and resource usage during intensive multi-file refactoring sessions
Debugging complex architectural changes where an agent might get trapped in a logic loop

About

Key Features

0 GitHub stars
Automated tracking of tool calls, duration, and file touchpoints
Intelligent stuck detection for circular edits and command loops
Manual progress markers with descriptive heartbeat recording
Detailed session history and state recovery capabilities
Real-time session health visualization with compact status lines

Use Cases

Resuming long-running development tasks by restoring state from previous sessions
Monitoring progress and resource usage during intensive multi-file refactoring sessions
Debugging complex architectural changes where an agent might get trapped in a logic loop