CC Conversation Search

Conversation Search

Find and resume past Claude Code conversations using smart hybrid extraction and JIT indexing. Get session IDs and project paths to easily jump back into previous work.

Features

- Session Resumption: Get exact commands to resume past conversations
- Unified CLI: Single cc-conversation-search command with intuitive subcommands
- Calendar Date Filtering: Intuitive --date yesterday, --since, --until parameters
- Smart Extraction: Hybrid indexing (full user content + smart assistant extraction)
- JIT Indexing: Instant indexing before search (no AI calls, no delays)
- Local Timezone Display: All timestamps shown in your local time
- Meta-Conversation Filtering: Automatically excludes search tool usage from results
- Progressive Exploration: Simple search → broader search → manual exploration
- Conversation Context: Expand context incrementally around any message
- Claude Code Skill: Integrated Skill that outputs session resumption commands
- Multi-Project Support: Works across all your Claude Code projects

Quick Start

Installation via Claude Code Plugin (Recommended)

Install the complete plugin (skill + CLI tool instructions) directly in Claude Code:

Then follow the installation instructions shown by Claude to:
1. Install the CLI tool: uv tool install cc-conversation-search
2. Initialize the database: cc-conversation-search init

Manual Installation

1. Install CLI Tool

2. Initialize Database

This creates the database and indexes your last 7 days of conversations.

3. Install Skill (Optional)

Basic Usage

Using with Claude Code Skill

Once installed, ask Claude:

Topic-based queries:
- "Find that conversation where we discussed authentication"
- "Locate the conversation about React hooks"
- "What did we talk about regarding the…