An integrated suite for managing the full lifecycle of Claude Code sessions, from keyword searching to automated history repair.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install session-tools
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install session-tools using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Session Management?
The Session Management skill is a robust utility designed to give developers granular control over their AI interaction history. As a key component of Openclaw Skills, it allows for deep inspection, organization, and optimization of the local session logs generated by Claude Code. It bridges the gap between raw session data and actionable insights by providing tools for classification, analysis, and data pipelining.
Whether you need to find a specific past conversation via keyword search, recover a broken session chain, or compress long histories to save on token usage, this skill provides a standardized interface for these complex operations. It ensures that your agent interactions remain structured, searchable, and efficient over long-term project development.
Session Management Use Cases
- Finding a specific session ID using keywords or file paths to reference past logic.
- Repairing broken session structures where tool results have lost their parent context.
- Summarizing lengthy developer-agent conversations to quickly regain context on a project.
- Cleaning up workspace clutter by classifying sessions for deletion or extraction.
- Transferring session data into other agents or analysis pipelines using the import functionality.
How Session Management Works
- The skill interfaces with the local Claude Code session storage, identifying projects based on normalized path strings.
- When a search or ID command is issued, it parses project JSONL files and applies filters based on modification time or keyword matches.
- For repair operations, it validates the integrity of message UUIDs and parent-child links within the session chain.
- Analysis commands process tool usage patterns and metadata, which can then be synced to external memory servers like Serena.
- Compression tasks utilize specialized MCP servers to reduce session size while preserving core semantic meaning for future context injection.
Session Management Setup
To use this skill within the Openclaw Skills framework, ensure you have the required MCP servers installed.
# Required: Install the claude-code-sessions MCP server
# Optional: Install Serena MCP server for --sync features
# Basic verification
/session id
Session Management Data Schema & Taxonomy
| Component | Description |
|---|---|
| Session UUID | The unique identifier for an individual chat session. |
| Project Name | Normalized path string (e.g., -Users-dev-project) used for storage. |
| JSONL Logs | The underlying message and tool_result data structure processed by the skill. |
| Session Titles | Custom human-readable labels assigned via the rename command. |
| Hook Events | Trigger points used for batch compression or pipelining data. |
Session Management Advanced Features
- Pipeline session data directly to other agents or tools via the hookify integration.
- Automated session repair for fixing orphaned tool_results and broken UUID chains.
- AI-driven session compression using code-mode to optimize context windows.
- Deep classification logic that can scan session depth to accurately categorize project topics.
- Seamless synchronization of session analysis stats to Serena memory for long-term agent persistence.
SKILL.md
Loading
Related Openclaw Skills
Input Safety Guard
A lightweight two-stage safety framework for AI agents to filter prompts and prevent injection attacks before response generation.
HF Daily Papers Digest
A streamlined automation skill to fetch, analyze, and generate professional digests from the HuggingFace Daily Papers feed.
git-quick
A lightweight Git intelligence tool that provides immediate visibility into repository status, commit history, and team contribution metrics.
Cyber Palace AI Roleplay
A fully autonomous AI agent skill that navigates a cyber-palace environment, making strategic social and political moves every two minutes.
TikTok Ad Library & Creative Discovery (PipiAds)
An AI agent skill for discovering and analyzing high-performing TikTok ad creatives and marketing patterns via the PipiAds database.
Facebook Adspy & Facebook Ad Library
A powerful research skill for analyzing Facebook ad creatives and Meta Ad Library data via the PipiAds API.
Featured*
