← Back to Skills Marketplace
180
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install claude-session
Description
Manage Claude Code sessions: lookup ID, import, summarize, analyze, classify, compress, delete, migrate, repair, rename, and generate web URLs.
README (SKILL.md)
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 \x3Csession_id> # summarize a specific session
Import (Pipeline Delivery)
/session import --hookify # deliver to hookify
/session import --analyze # analysis pipeline
/session import --to \x3Cagent> # deliver to specific agent
Analyze (Session Analysis)
/session analyze # analyze current session
/session analyze \x3Csession_id> # analyze specific session
/session analyze --sync # sync to Serena memory
Split (Topic Split Recommendation)
/session split # Recommend split for current conversation
/session split \x3Csession_id> # Recommend split for specific session
/session split --execute # Execute recommendation immediately
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.
Move (Move Specific Sessions by ID)
/session move \x3Csession_id> [session_id2 ...] \x3Ctarget_project_path>
Move explicit session IDs to another project directory and update cwd references. 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 \x3Csource> \x3Ctarget> # specify source/target projects
Classifies sessions as CODE/INFRA/TINY/READ, then moves CODE sessions to worktree project and optionally deletes TINY sessions.
Compress (Session Compression)
/session compress \x3Csession_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 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
Destroy (Delete Session)
scripts/destroy-session.sh
Purge (Dead Session Cleanup)
/session purge # dry-run: list dead sessions in current project
/session purge \x3Cproject_name> # dry-run: specific project
/session purge --all # dry-run: all projects
Dead session = 10 lines or fewer + no "type":"assistant" response.
Script: scripts/purge-dead-sessions.sh \x3Cproject_name> [--delete]
Repair (Session Recovery)
/session repair # select session, then validate and repair
/session repair \x3Csession_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 \x3Csession_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 \x3Csession_id>
# List named sessions in current project
bash scripts/rename-session.sh --list
Project Name Conversion Rules
| Actual Path | Project Name |
|---|---|
/Users/es6kr/works/.vscode |
-Users-david-works--vscode |
/Users/es6kr/Sync/AI |
-Users-david-Sync-AI |
Rule: / → -, remove leading / from path
Requirements
- claude-sessions-mcp MCP server required
- Serena MCP server (when using analyze --sync)
Usage Guidance
This skill manipulates your local Claude Code session files (~/.claude/projects). Before installing or invoking it: 1) Review the scripts in the repository (they will run file operations: mv, rm, sed, jq, python scripts). 2) Back up ~/.claude/projects; note the skill's own backup behavior may overwrite previous backups. 3) Use dry-run/check-only flags where available (repair, migrate, compress have dry-run options). 4) Be cautious with 'import'/'pipeline' features — they can send entire session contents to other agents or memory services (check and redact secrets first). 5) If you follow instructions that run 'npx claude-sessions-mcp' or similar, vet that npm package before execution. 6) Avoid enabling autonomous invocation for this skill in contexts where it could run destructive commands without explicit user consent.
Capability Analysis
Type: OpenClaw Skill
Name: claude-session
Version: 0.1.3
The skill bundle provides extensive tools for managing Claude Code session files, including deletion, modification, and UI automation. Key indicators include scripts that permanently delete session data (purge-dead-sessions.sh), modify session history (repair-session.py, rename-session.sh), and use AppleScript to automate VSCode UI interactions (restart-extension-host.sh). While these actions are aligned with the stated purpose of session management, the high-privilege file operations and UI control represent a significant attack surface if the agent is misdirected via prompt injection.
Capability Assessment
Purpose & Capability
The skill's name and description (manage Claude Code sessions) align with the code and docs: the scripts operate on ~/.claude/projects/*.jsonl, provide summarization, repair, move, delete, compress, etc. However the skill metadata claims no required config paths or credentials while the runtime instructions and scripts clearly require direct filesystem access to ~/.claude/projects and expect local MCP tools (claude-sessions-mcp). That mismatch (declared requirements: none vs actual need to read/write ~/.claude/projects and to call mcp tools) is an incoherence the user should be aware of.
Instruction Scope
SKILL.md and the included scripts instruct the agent to read, modify, move, and permanently delete session JSONL files under ~/.claude/projects, run jq/sed/python scripts, create/overwrite backups, and restart extension hosts. Those destructive and wide-scope file operations are consistent with the stated purpose but are powerful and irreversible in places (deletes, overwrites backups, compression noted as irreversible). The skill also documents pipelines that deliver full session content to other agents/services (e.g., mcp__serena__write_memory, 'hookify' pipelines and Task tool subagents). Delivering session content can leak sensitive information unless manually reviewed—the docs warn about this, but the ability is within the skill and broad in scope.
Install Mechanism
There is no formal install spec (instruction-only), which reduces installer risk. However the docs reference registering/using claude-sessions-mcp via UTCP and show an npx command (npx -y claude-sessions-mcp), meaning the runtime may implicitly fetch and run a package from npm if the user follows instructions. Using npx to pull an external package is a moderate-risk install step; it is traceable but still a remote code execution vector if performed without vetting.
Credentials
The skill declares no environment variables or credentials (correct), so there is no obvious credential overreach. That said, the skill reads/writes files in the user's home (~/.claude) and can call MCP tools that forward data to other agents or memory stores (mcp__serena__write_memory), which could transmit session contents (potentially including API keys or secrets) outside the local machine if configured. The skill documents this behavior and includes a manual-review recommendation, but automatic pipelines present an exfiltration risk if used without caution.
Persistence & Privilege
The skill is not always-enabled and does not request elevated platform privileges in metadata. It does perform persistent filesystem changes to user session files (backups, moves, deletes) as part of its normal operation, which is expected for this functionality. It does not claim to modify other skills' configurations.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install claude-session - After installation, invoke the skill by name or use
/claude-session - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.3
Add move topic for session relocation by ID, add API 400 error detection to repair
v0.1.2
Improve clean-profanity script
v0.1.1
Version bump with latest improvements
v0.1.0
Initial release: id, import, summarize, analyze, classify, compress, destroy, migrate, repair, rename, url
Metadata
Frequently Asked Questions
What is Claude Session?
Manage Claude Code sessions: lookup ID, import, summarize, analyze, classify, compress, delete, migrate, repair, rename, and generate web URLs. It is an AI Agent Skill for Claude Code / OpenClaw, with 180 downloads so far.
How do I install Claude Session?
Run "/install claude-session" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Claude Session free?
Yes, Claude Session is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Claude Session support?
Claude Session is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Claude Session?
It is built and maintained by es6kr (@drumrobot); the current version is v0.1.3.
More Skills