SkillHub ClubShip Full StackFull Stack

search-history

Search Claude conversation history from JSONL files. Use when looking for previous discussions, past decisions, code solutions, or context from earlier conversations.

Packaged view

This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.

Stars

Hot score

Updated

March 20, 2026

Overall rating

C2.2

Composite score

2.2

Best-practice grade

C56.0

Install command

npx @skill-hub/cli install roger-parkinson-ehp-agentic-search-history

Repository

Roger-Parkinson-EHP/agentic

Skill path: 5.2-Coding-Assistants/5.2.1-Claude-Code/skills/search-history

Search Claude conversation history from JSONL files. Use when looking for previous discussions, past decisions, code solutions, or context from earlier conversations.

Open repository

Best for

Primary workflow: Ship Full Stack.

Technical facets: Full Stack.

Target audience: everyone.

License: Unknown.

Original source

Catalog source: SkillHub Club.

Repository owner: Roger-Parkinson-EHP.

This is still a mirrored public skill entry. Review the repository before installing into production workflows.

What it helps with

Install search-history into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
Review https://github.com/Roger-Parkinson-EHP/agentic before adding search-history to shared team environments
Use search-history for development workflows

Works across

Claude CodeCodex CLIGemini CLIOpenCode

Favorites: 0.

Sub-skills: 0.

Aggregator: No.

Original source / Raw SKILL.md

---
name: search-history
description: Search Claude conversation history from JSONL files. Use when looking for previous discussions, past decisions, code solutions, or context from earlier conversations.
allowed-tools: Bash, Read
---

# Conversation History Search

Search through Claude Code conversation history to find relevant past discussions.

## When to Use

- Finding previous discussions about a topic
- Recalling past decisions or solutions
- Getting context from earlier conversations
- Looking up how something was implemented before

## How to Search

Run the search script from the services directory:

```bash
cd ~/.claude/services
python conversation-search.py "search term"
```

## Search Options

| Option | Description |
|--------|-------------|
| `--list-sessions`, `-l` | List all sessions with metadata |
| `--session ID`, `-s` | Filter to specific session (partial match) |
| `--context N`, `-c` | Show N messages before/after (default: 3) |
| `--max N`, `-m` | Maximum results (default: 20) |
| `--verbose`, `-v` | Show context messages |
| `--full`, `-f` | Show full message content |

## Examples

```bash
# List all available sessions
python conversation-search.py --list-sessions

# Basic search
python conversation-search.py "bulk upload"

# Regex search
python conversation-search.py "context.*percent|usage.*%"

# Search specific session with full output
python conversation-search.py "statusline" --session 6cabef43 --full

# Get more context around matches
python conversation-search.py "error" --context 5 --verbose --max 3
```

## Output Modes

1. **Default**: Preview snippet (50 chars before, 100 after match)
2. **Verbose** (`-v`): Adds surrounding message context
3. **Full** (`-f`): Complete message content

## Token Efficiency

The search runs externally, so searching costs 0 tokens. Only the returned results consume context.