Conversation History Setup

This skill helps users get started with the conversation-history plugin.

When to Use

Invoke this guidance when:

• User asks how to set up conversation history

• User asks about indexing past/historical conversations

• Search returns no results and user seems surprised

• User mentions they just installed the plugin

Initial Setup

After installing the conversation-history plugin, users should index their existing conversations:

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

Or they can run the command: /conversation-history:index-history

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

How It Works

Automatic indexing: After setup, new conversations are automatically indexed via a Stop hook that fires when Claude finishes responding.

Database location: ~/.claude/conversation-history.db

• persists even after JSONL files are cleaned up.

Incremental: The indexer tracks what's already indexed and only processes new content.

If Search Returns Nothing

If a user searches and gets no results:

• Check if they've run the initial indexing

• Suggest running /conversation-history:index-history to populate the database

• Note that only conversations since the plugin was installed (or since running index-history) will be searchable