---
name: conversation-search
description: Search indexed conversation history to find past conversations, locate when topics were discussed, or identify which project conversations occurred in. Use when user asks questions like "when did we discuss X?", "find conversations about Y", "in which project did we talk about Z?", or "show me conversations mentioning W". Works across all projects or within current project.
---

# 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
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.
