GitHub

Claude Code Search — Semantic Search Over Conversation History

Anoop Sharma

— 1 min read

GitHub: anoop22/claude-code-search

Semantic search over your Claude Code conversation history. Find past implementations, recall discussions, and recover context from previous sessions.

Why?

Claude Code stores conversations in .jsonl files at ~/.claude/projects/. These files pile up quickly. This tool indexes your history and lets you search semantically.

Features

  • Semantic Search: Natural language queries
  • Topic Detection: Auto-recognizes programming topics
  • Query Expansion: Synonym matching
  • Project & Date Filtering
  • Auto-Indexing: Indexes on first search
  • Incremental Updates: Only re-indexes changes

Quick Start

git clone https://github.com/anoop22/claude-code-search.git
cd claude-code-search && pip install .

claude-search search "authentication implementation"
claude-search topic database
claude-search latest myproject

How It Works

  1. Scans ~/.claude/projects/ for .jsonl files
  2. Extracts messages, timestamps, project info
  3. Creates embeddings via all-MiniLM-L6-v2
  4. Stores in ChromaDB
  5. Cosine similarity search with ranking

Python 3.10+ · MIT License

Read more