Can I use the session ID in Bash hooks?

Yes, Bash hooks receive the session ID via stdin JSON. You can extract it using tools like jq by reading the .session_id field.

How do I access the session ID in a script?

Simply use the ${CLAUDE_SESSION_ID} variable in your skill or command templates; Claude Code substitutes it with the actual UUID automatically when loading.

Is the session ID unique for every chat?

Yes, Claude Code assigns a unique UUID v4 to every conversation session to ensure data isolation and prevent history collisions.

Where are the session history files stored?

They are typically stored as JSONL files in the ~/.config/projects/-workspace/ directory, utilizing the session UUID as the filename.

What is the primary purpose of the session ID?

It is used for naming history files, tracking session-specific TODO lists, coordinating hooks, and establishing task ownership in multi-instance scenarios.

Session ID Management

Name: Session ID Management
Author: cowwoc

bycowwoc

•

分析与监控

Accesses and utilizes unique session identifiers via automatic variable substitution for precise conversation tracking and history management.

The Get Session ID skill enables Claude Code to automatically reference and track unique session UUIDs using the ${CLAUDE_SESSION_ID} variable. This capability is essential for managing conversation history files, coordinating hooks across multiple tools, and maintaining session-specific TODO lists or task ownership. By eliminating manual lookup, it streamlines the development of session-aware scripts and tools that require isolated context from the current AI interaction, ensuring data integrity across multi-instance environments.

主要功能

01Automatic substitution of ${CLAUDE_SESSION_ID} in skill templates

02Unique UUID v4 generation for every interaction session

0356 GitHub stars

04Session-specific conversation history file mapping and retrieval

05Coordination of hooks and task ownership across tool instances

06JSON-based session ID extraction for Bash hook scripts

使用场景

01Managing task ownership and state in multi-instance development environments

02Retrieving specific message logs from a session's unique JSONL history file

03Implementing session-aware Bash hooks for automated task reporting

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cowwoc/cat get-session-id

For use in Claude.ai and ChatGPT

Download Skill