Conversation History Search

Search through indexed past conversations with Claude to find relevant discussions.

How to Search

Run the search command with the user’s query:

bash ${CLAUDE_PLUGIN_ROOT}/skills/conversation-search/scripts/search.sh --query "search terms" --limit 10

Options:

• --query: Search terms (required). Supports prefix matching.
• --limit: Maximum results (default: 20)
• --json: Output results as JSON for programmatic processing

Presenting Results

Show the user:

• Number of matching conversations found
• For each result: conversation ID, project path, date, and snippet
• Suggest using /conversation-history:load-conversation <id> to load full transcripts

First-Time Setup

If search returns no results and the user seems surprised, they may need to run the initial indexing:

/conversation-history:index-history

This indexes all existing conversations from ~/.claude/projects/ into the database.