Index Historical Conversations

Run this command after installing the plugin to index your existing conversation history.

This command scans all existing conversation files in ~/.claude/projects/ and indexes them into the conversation history database at ~/.claude/conversation-history.db.

Why This Is Needed

The conversation-history plugin automatically indexes new conversations as they happen. However, it can't know about conversations that occurred before the plugin was installed. Running this command "primes the pump" by indexing all your existing conversations.

When to Use

• First install: Run immediately after installing the plugin
• Missing conversations: If searches aren't finding conversations you expect
• Rebuild: To rebuild the index from scratch

Instructions

Run the indexing script:

bash ${CLAUDE_PLUGIN_ROOT}/skills/getting-started/scripts/index-history.sh

What It Does

1. Scans all project directories under ~/.claude/projects/
2. Finds all .jsonl conversation files
3. Parses and indexes user/assistant messages from each conversation
4. Skips conversations that are already fully indexed (incremental)

Output

You'll see progress as conversations are indexed:

Indexed: abc12345 (47 messages, project: .../my-project)
Indexed: def67890 (23 messages, project: .../another-project)

Indexing complete:
  New/updated conversations: 42
  Already indexed (skipped): 15
  Total messages indexed: 1847
  Database: ~/.claude/conversation-history.db

Notes

• This may take a while if you have many conversations
• The indexer is incremental - running it multiple times is safe
• After this initial setup, new conversations are indexed automatically