cc-convo-explorer

Search local Claude Code JSONL history by keyword or session.

3|1|Updated Dec 4, 2025

Search Tags:#search #history #claude-code #conversations #jsonl #context-retrieval

Ready to run

npx skills add https://github.com/cardoso-neto/personal-ai-infra --skill cc-convo-explorer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: cc-convo-explorer
Source: https://github.com/cardoso-neto/personal-ai-infra/tree/main/skills/cc-convo-explorer
Command: npx skills add https://github.com/cardoso-neto/personal-ai-infra --skill cc-convo-explorer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code conversations are stored across per-project JSONL files and a central history log, making it hard to locate prior context when continuing work. This Skill centralizes discovery and retrieval, enabling fast access to relevant past chats to inform current decisions.

Core Features & Use Cases

Knowledge of Claude Code history storage locations and encoding schemes.
Keyword and session-based search across ~/.claude/projects and ~/.claude/history.jsonl to restore relevant conversations.
Context restoration and quick reference by summarizing or extracting matching snippets for reuse in ongoing work.
Use Case: When resuming work after a long break, you can quickly fetch past conversations related to a project to reconstruct decisions and guidance.

Quick Start

Search Claude Code conversations by project path or keyword to quickly regain context.

Frequently Asked Questions about cc-convo-explorer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I search Claude Code conversation history by keyword?▼

Search Claude Code conversation history by filtering JSONL records stored under ~/.claude/projects and the global history file. This centralizes discovery and retrieval, enabling fast access to relevant past chats to inform current decisions.

How do I restore context from past Claude Code sessions when resuming work?▼

Restore context from past Claude Code sessions by retrieving and summarizing matching conversation snippets. When resuming work after a break, you can fetch past chats related to a project to reconstruct decisions and guidance.

Can I search large Claude Code JSONL files without loading them entirely into memory?▼

Yes, you can search large Claude Code JSONL files without loading them entirely into memory. The Skill applies size-aware streaming to parse and analyze large history records efficiently, avoiding memory overload.

Does Claude Code store conversations globally or per project?▼

Claude Code stores conversations both globally and per project. Records are saved as per-project JSONL files under ~/.claude/projects alongside a central history log at ~/.claude/history.jsonl, using encoded project paths for organization.

What is the best way to locate a specific Claude Code chat by session ID?▼

The best way to locate a specific Claude Code chat by session ID is using session-based filtering across local history files. This supports project-aware context retrieval to quickly regain relevant conversation history.

Why are my Claude Code project paths encoded in the local history directory?▼

Claude Code project paths are encoded in the local history directory to map file system structures to flat storage safely. The Skill parses these encoded project paths within ~/.claude/projects to correctly retrieve JSONL conversation logs.