Session Tools

Manage Claude Code sessions: lookup ID, search, import, summarize, analyze, classify, compress, delete, repair, and rename sessions accurately.

Session

Integrated skill for managing Claude Code sessions.

Topics

Topic	Description	Guide
analyze	Session statistics, tool usage patterns, optimization insights	analyze.md
classify	Classify project sessions (delete/keep/extract)	classify.md
compress	AI-compress sessions via UTCP/code-mode	compress.md
destroy	Delete current session and restart IDE	destroy.md
id	Look up current session ID (UUID)	id.md
import	Pipeline session data to other agents/skills	import.md
rename	Assign and look up custom title for session	rename.md
repair	Restore session structure (chain, tool_result, UUID)	repair.md
summarize	View and summarize conversation content from other sessions	summarize.md

Quick Reference

Summarize (View/Summarize Sessions)

/session summarize                 # select project/session then summarize
/session summarize <session_id>    # summarize a specific session

Detailed guide

Import (Pipeline Delivery)

/session import --hookify          # deliver to hookify
/session import --analyze          # analysis pipeline
/session import --to <agent>       # deliver to specific agent

Detailed guide

Analyze (Session Analysis)

/session analyze                   # analyze current session
/session analyze <session_id>      # analyze specific session
/session analyze --sync            # sync to Serena memory

Detailed guide

Classify (Session Classification)

/session classify                  # classify current project sessions
/session classify --depth=medium   # required when classifying sessions scheduled for split
/session classify --execute        # execute immediately after classification

⚠️ --depth=medium or higher required before split — fast only reads the last 3 messages, so it may miss different topics at the end of the session.

Detailed guide

Compress (Session Compression)

/session compress <session_id>    # compress specific session
/session compress                 # batch compress sessions containing "hookEvent":"Stop"

Register claude-sessions-mcp with UTCP, then call via code-mode.

Detailed guide

ID (Session ID Lookup + Keyword Search)

/session id                          # look up current session ID
/session id Makefile remove          # search sessions by keyword
/session id --today ansible/Makefile # search only today's sessions by file path

Current session ID: output unique marker → search JSONL with find-session-id.sh → return UUID Keyword search: grep project JSONL → sort by modification time descending → return most recent matching session

Detailed guide

Destroy (Delete Session)

scripts/destroy-session.sh

Detailed guide

Repair (Session Recovery)

/session repair                          # select session, then validate and repair
/session repair <session_id>             # repair specific session
/session repair --dry-run                # preview only
/session repair --check-only             # validate only (no repair)

Repair targets:

• Broken chain (missing parentUuid)
• Orphan tool_result (no matching tool_use)
• Duplicate UUIDs

Detailed guide

Rename (Naming a Session)

# Assign a name to a specific session
bash ~/.claude/skills/session/scripts/rename-session.sh <session_id> "name"

# Assign a name to the latest session in the current project
bash ~/.claude/skills/session/scripts/rename-session.sh "name"

# Check current title
bash ~/.claude/skills/session/scripts/rename-session.sh --show <session_id>

# List named sessions in current project
bash ~/.claude/skills/session/scripts/rename-session.sh --list

Detailed guide

Project Name Conversion Rules

Actual Path	Project Name
/Users/david/works/.vscode	-Users-david-works--vscode
/Users/david/Sync/AI	-Users-david-Sync-AI

Rule: / → -, remove leading / from path

Requirements

• claude-code-sessions MCP server required
• Serena MCP server (when using analyze --sync)