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

0•

Analytics & Monitoring

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

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

010 GitHub stars

02Automated tracking of tool calls, duration, and file touchpoints

03Intelligent stuck detection for circular edits and command loops

04Manual progress markers with descriptive heartbeat recording

05Detailed session history and state recovery capabilities

06Real-time session health visualization with compact status lines

Use Cases

01Resuming long-running development tasks by restoring state from previous sessions

02Monitoring progress and resource usage during intensive multi-file refactoring sessions

03Debugging complex architectural changes where an agent might get trapped in a logic loop

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jrc1883/popkit-claude pop-heartbeat

For use in Claude.ai and ChatGPT

Key Features

010 GitHub stars

02Automated tracking of tool calls, duration, and file touchpoints

03Intelligent stuck detection for circular edits and command loops

04Manual progress markers with descriptive heartbeat recording

05Detailed session history and state recovery capabilities

06Real-time session health visualization with compact status lines

Use Cases

01Resuming long-running development tasks by restoring state from previous sessions

02Monitoring progress and resource usage during intensive multi-file refactoring sessions

03Debugging complex architectural changes where an agent might get trapped in a logic loop

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jrc1883/popkit-claude pop-heartbeat

For use in Claude.ai and ChatGPT