Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

claude-session-tools

verified

This skill should be used when the user asks to "find Claude sessions", "explore session history", "search Claude sessions", "analyze session", "list sessions", "extract session content", "export Claude sessions", "find tool usage in sessions", "session timeline", mentions "Claude Code session.jsonl files", or needs to explore, search, analyze, or export Claude Code session histories stored in ~/.claude/projects/.

View on GitHub

Marketplace

clautorun

ahundt/clautorun

Plugin

clautorun

productivity

Repository

ahundt/clautorun

plugins/clautorun/skills/claude-session-tools/SKILL.md

Last Verified

February 4, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/ahundt/clautorun/blob/main/plugins/clautorun/skills/claude-session-tools/SKILL.md -a claude-code --skill claude-session-tools

Installation paths:

Claude
.claude/skills/claude-session-tools/
Powered by add-skill CLI

Instructions

# Claude Session Tools

General-purpose tool for exploring, searching, analyzing, and exporting Claude Code session histories stored in `~/.claude/projects/`.

**Usage:**
- `/cr:claude-session-tools` - Show full guide
- `/cr:claude-session-tools list <PROJECT>` - List all sessions for a project
- `/cr:claude-session-tools search <PATTERN>` - Search sessions for pattern
- `/cr:claude-session-tools extract <PROJECT> <SESSION-ID> <TYPE>` - Extract specific content
- `/cr:claude-session-tools analyze <PROJECT> <SESSION-ID>` - Analyze session structure
- `/cr:claude-session-tools timeline <PROJECT> <SESSION-ID>` - Show chronological timeline
- `/cr:claude-session-tools cross-ref <PROJECT> <SESSION-ID> <FILE>` - Cross-reference with file
- `/cr:claude-session-tools find-tool <TOOL> <PATTERN>` - Find specific tool usage
- `/cr:claude-session-tools corrections [PROJECT]` - Find user correction patterns
- `/cr:claude-session-tools find-commands <PATTERN> [CONTEXT]` - Search for command patterns
- `/cr:claude-session-tools planning-usage` - Analyze planning command usage
- `/cr:claude-session-tools export <PROJECT> <SESSION-ID> [OUTPUT]` - Export session to markdown
- `/cr:claude-session-tools export-recent [DAYS] [OUTPUT]` - Export recent sessions to single file

## Arguments

This command accepts arguments for automated operations:

```
$ARGUMENTS
```

## Operations

### Session Discovery

**`list <PROJECT>`**
Show all sessions for a project with metadata.

```
/cr:claude-session-tools list repomix
```

### Content Extraction

**`extract <PROJECT> <SESSION-ID> <TYPE>`**
Extract specific content type from a session.

Types: `pbcopy`, `bash-output`, `user-prompts`, `assistant-responses`, `tool-usage`, `all`

```
/cr:claude-session-tools extract repomix 6ab3b336 user-prompts
/cr:claude-session-tools extract repomix 6ab3b336 pbcopy
```

### Analysis Operations

**`search <PATTERN>`**
Find pattern across all sessions and projects.

```
/cr:claude-session-tools search "your-patte

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
15077 chars