Claude History Explorer — Development skill for Claude Code

Claude History Explorer

[](https://github.com/adewale/claude-history-explorer/actions/workflows/ci.yml)

A Python CLI tool to explore, search and visualise your Claude Code conversation history. The history is stored locally at `~/.claude/projects/` and this tool turns raw JSONL files into searchable conversations and insights about your coding journey.

Highlights

• Story Generation - Analyzes sessions to create narratives about work patterns, personality traits, and collaboration style
• Concurrent Claude Detection - Identifies when you've used multiple Claude instances in parallel
• Rich Terminal UI - Tables, panels, sparklines, and syntax highlighting
• Multiple Export Formats - JSON, Markdown, plain text
• Regex Search - Search across conversations with Python regex plus a basic ReDoS safety guard
• Read-Only by Design - Never modifies your Claude history files (why trust this?)
• Streaming JSONL - Line-by-line parsing handles large files efficiently

Example Output

📖 Keyboardia Project Story
============================

📅 3 days of development
🤝 heavy delegation (16 agents, 2 main sessions)
⚡ 1873 messages at 25.0 msgs/hour
🎯 steady, productive flow with marathon sessions
🎭 agent-driven, deep-work focused, high-intensity
🔀 Used up to 3 Claude instances in parallel

💡 Key insight: Most productive session: 1530 messages

Installation

Using `uv` (recommended):

# Install directly
uv tool install .

# Or run without installing
uv run claude-history --help

Using pip:

pip install .

Usage

**Tip:** Every command supports `--example` to show usage examples: `claude-history search --example`

projects

List all Claude Code projects sorted by last use.

claude-history projects
claude-history projects -n 10        # Limit to 10 projects

| Option | Description |