Claude Search

Claude Search

Semantic search tool for searching across your entire Claude conversation history stored in `~/.claude/projects/`.

Overview

This tool extracts all text content from your Claude Code conversation history (JSONL files) and performs semantic search using embeddings. It helps you quickly find relevant conversations, answers, and discussions from your past Claude sessions.

Features

• Interactive Selection: Browse search results with an interactive menu
• Semantic Search: Uses AI embeddings (via semtools) for intelligent, meaning-based search
• Full Conversation Export: Copies entire conversations (including tool uses) to clipboard
• Rich Metadata: Shows project, role (user/assistant), timestamp, and session info
• Fast: Processes thousands of conversation entries efficiently
• Cross-Platform: Built with Bun and TypeScript (clipboard support for macOS, Linux, Windows)

Prerequisites

1. Bun: Install from bun.sh
2. semtools search command: Install via npm

   npm install -g @llamaindex/semtools

Installation

# Clone the repository
git clone https://github.com/johnlindquist/claude-search.git
cd claude-search

# Install dependencies
bun install

Usage

Interactive Search (Default)

The default mode shows an interactive menu where you can browse results and select one to copy the full conversation to clipboard:

bun run index.ts "your search query"

**Workflow:**

1. Enter your search query
2. Browse the sorted results (by relevance/distance)
3. Select a result with arrow keys
4. Press Enter to copy the full conversation to clipboard
5. Paste anywhere!

Examples

# Interactive search with default settings (top 10 results)
bun run index.ts "authentication methods"

# Show more results in the menu
bun run index.ts "react hooks" --top-k 15

# Filter by distance threshold
bun run index.ts "bug in user registration" --max-distance 0.4