How do I resume a discovered session?

Once the skill identifies a resumable session ID and confirms its health, you can use the 'claude --resume ' command in the appropriate directory.

What is the difference between a Stale and a Zombie session?

A Stale session is a running process with no activity for 5-30 minutes, while a Zombie session is a process that is unresponsive, corrupted, or has no heartbeat for over 30 minutes.

Does it require a database to function?

No, while it can integrate with PostgreSQL for advanced heartbeats, it works perfectly using filesystem and process discovery alone.

How does this skill detect a corrupted session?

It analyzes the session's JSONL file for sizes exceeding 50MB, checks for null content entries, and validates file permissions.

Can I use this to manage sessions across different Git branches?

Yes, the skill maps session metadata like CWD and branch names to your active Git worktrees to help you find the right context.

Claude Session Discovery

Name: Claude Session Discovery
Author: wildcard

bywildcard

•

Productividad y Flujo de Trabajo

Monitors and analyzes Claude Code sessions across terminals and Git worktrees to optimize developer workflows and troubleshoot session health.

The Session Discovery skill provides Claude with advanced capabilities to track, diagnose, and manage concurrent Claude Code sessions. It enables deep visibility into session states by cross-referencing running process data with filesystem metadata, Git worktree paths, and optional PostgreSQL heartbeat data. This skill is essential for developers working across multiple branches or directories who need to identify active sessions, recover from process hangs, and ensure session file integrity before resuming work.

Características Principales

01Contextual mapping between sessions, Git branches, and local worktrees

0226 GitHub stars

03Automated session health diagnostics including file size and corruption checks

04Database integration for querying session heartbeats and project metadata

05Rapid extraction of last user prompts and assistant responses for context

06Real-time process monitoring to identify active, stale, and zombie sessions

Casos de Uso

01Diagnosing why a session fails to resume by checking for JSONL corruption

02Finding and resuming a specific session associated with a background Git worktree

03Identifying and cleaning up hung Claude processes to reclaim system resources

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add wildcard/caro session-discovery

For use in Claude.ai and ChatGPT

Download Skill