skills.rest
kudrmax
kudrmaxCOMMUNITY
Explore all skills by this author →
GitHub

search-conversations

Search past Claude Code sessions across projects using keyword queries.

1|Updated Nov 6, 2024
Search Tags:#context#logs#recall#search#history#sessions#claude-code
One-click install
npx skills add https://github.com/kudrmax/macos-setup --skill search-conversations-kudrmax
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: search-conversations
Source: https://github.com/kudrmax/macos-setup/tree/main/home/.claude/skills/search-conversations
Command: npx skills add https://github.com/kudrmax/macos-setup --skill search-conversations-kudrmax

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you recall and locate information from past Claude Code conversations across all projects, enabling quick access to decisions, context, and history.

Core Features & Use Cases

  • Index scans and references all user messages in ~/.claude/history.jsonl and per-session logs in ~/.claude/projects/ to enable fast search.
  • Context Retrieval returns sessionId, project path, and timestamp to reconstruct the conversation context.
  • Use Case: when you need to remember what was discussed about a project or a decision, search Claude Code history to retrieve the relevant conversation.

Quick Start

Search all past Claude Code sessions across all projects by querying the history index for your keyword.

Frequently Asked Questions about search-conversations

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

FAQPage Schema
How do I search past Claude Code sessions across all projects?▼

To search past Claude Code sessions, query the history index using keywords to scan user messages in ~/.claude/history.jsonl and per-session logs in ~/.claude/projects/, returning matching sessionId, project path, and timestamp for context.

What is the best way to recall a decision from previous Claude Code history logs?▼

Recalling decisions from Claude Code history logs is done by performing a keyword-based retrieval against local JSONL files, which provides the exact session ID and timestamp needed to reconstruct the past conversation context.

Does searching Claude Code conversation history require any specific local files?▼

Searching Claude Code conversation history requires local access to the history.jsonl file and per-session logs stored within the ~/.claude/projects/ directory to read JSONL data and retrieve matching records.

Can I retrieve the project path and session ID from a past Claude Code conversation?▼

You can retrieve the project path and session ID from past conversations by searching the indexed history logs, which return these specific metadata fields alongside timestamps to help you quickly locate the original context.

What information do I get back when searching through Claude Code session logs?▼

When searching through Claude Code session logs, you get the matching user messages, the unique session ID, the specific project path, and the timestamp, allowing you to fully reconstruct the historical conversation context.

Related Skills

Explore More Content & Communication Skills→
toqoztoqoz

scan-abandoned-sessions

Analyze JSONL session tails to classify abandoned Claude Code sessions.

Community
Advanced
akatz-aiakatz-ai
26

conversation-search

Search past Claude Code conversations by topic, date, or both to return session IDs and resume commands.

Community
Advanced
cskirocskiro
7

cc-insights

Index and analyze Claude Code conversation histories for semantic search and insights.

Community
Advanced
teklinertekliner
10

claude-code-sessions

Locate, resume, and analyze Claude Code sessions across projects via grep search.

Official
Intermediate