- name
- claude-session
- metadata
- author
- es6kr
- version
- 0.1.4
- 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, migrate - move sessions between projects (main repo to worktree), move - move specific sessions by ID to another project + update cwd [move.md], repair - restore session structure (chain, tool_result), rename - assign custom title to session, url - generate claude-sessions web URL from session ID, 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 migrate", "session move", "move session to project", "update session cwd", "worktree session", "move session", "worktree session move", "session repair", "session rename", "chain repair", "session url", "session web URL", "claude-sessions url", "session split", "split recommendations", "topic split", "session purge", "dead session", "clean dead sessions", "session cleanup
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 |
| split | Analyze topic boundaries and recommend session split points | split.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 |
| migrate | Move sessions between projects (main repo → worktree) | migrate.md |
| move | Move specific sessions by ID to another project + update cwd | move.md |
| purge | Delete dead sessions (hook-only, no assistant response) permanently | purge.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 |
| url | Generate claude-sessions web URL from session ID | url.md |
Quick Reference
Summarize (View/Summarize Sessions)
/session summarize # select project/session then summarize
/session summarize <session_id> # summarize a specific sessionImport (Pipeline Delivery)
/session import --hookify # deliver to hookify
/session import --analyze # analysis pipeline
/session import --to <agent> # deliver to specific agentAnalyze (Session Analysis)
/session analyze # analyze current session
/session analyze <session_id> # analyze specific session
/session analyze --sync # sync to Serena memorySplit (Topic Split Recommendation)
/session split # Recommend split for current conversation
/session split <session_id> # Recommend split for specific session
/session split --execute # Execute recommendation immediatelyClassify (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.
Move (Move Specific Sessions by ID)
/session move <session_id> <target_project_path> # default: AskUserQuestion for cwd mode
/session move <session_id> <target_project_path> --cwd-mode all # update all cwd occurrences
/session move <session_id> <target_project_path> --cwd-mode first # update only first cwdMove explicit session IDs to another project directory and update cwd references via Python script. Cross-platform (Windows + macOS/Linux). Unlike migrate, no classification — just direct move.
Migrate (Move Sessions Between Projects)
/session migrate # classify + move code sessions to worktree
/session migrate --dry-run # preview only
/session migrate <source> <target> # specify source/target projectsClassifies sessions as CODE/INFRA/TINY/READ, then moves CODE sessions to worktree project and optionally deletes TINY sessions.
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.
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 pathCurrent 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
Destroy (Delete Session)
scripts/destroy-session.shPurge (Dead Session Cleanup)
/session purge # dry-run: list dead sessions in current project
/session purge <project_name> # dry-run: specific project
/session purge --all # dry-run: all projectsDead session = 10 lines or fewer + no "type":"assistant" response. Script: scripts/purge-dead-sessions.sh <project_name> [--delete]
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
Rename (Naming a Session)
# Assign a name to a specific session
bash scripts/rename-session.sh <session_id> "name"
# Assign a name to the latest session in the current project
bash scripts/rename-session.sh "name"
# Check current title
bash scripts/rename-session.sh --show <session_id>
# List named sessions in current project
bash scripts/rename-session.sh --listProject Name Conversion Rules
| Actual Path | Project Name |
|---|---|
/Users/user/works/.vscode | -Users-user-works--vscode |
/Users/user/Sync/AI | -Users-user-Sync-AI |
Rule: / → -, remove leading / from path
Requirements
- claude-sessions-mcp MCP server required
- Serena MCP server (when using analyze --sync)