Session Tools

---

name: session description: Integrated skill for Claude Code session management. id - look up current session ID + keyword session search, import - import session, summarize - summarize session, analyze - session stats/analysis, classify - classify/organize sessions, compress - compress session, destroy - delete current session, repair - restore session structure (chain, tool_result), rename - assign custom title to session, Use when: "session ID", "current session", "session id", "get session", "session analysis", "session classify", "session compress", "session delete", "session repair", "chain repair", "session name", "name session", "session search", "find session", "which session", "session import", "session analyze", "session classify", "session compress", "session repair", "session rename", "chain repair"

---

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     # summarize a specific session

Detailed guide

Import (Pipeline Delivery)

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

Detailed guide

Analyze (Session Analysis)

/session analyze                   # analyze current session
/session analyze       # 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     # 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              # 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  "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 
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)