Semantic search across your Claude Code conversation history, powered by Qdrant.
uv tool install claude-kbdocker compose up -dkb init
kb import claude-code-chatsclaude mcp add -s user kb -- kb mcpThat's it. Claude Code now has access to kb_search and kb_get tools for searching your conversation history.
uv tool upgrade claude-kbTo check current version:
kb --versionkb search "your query" # semantic search
kb search "query" --limit 20 # with options
kb get <message-id> # retrieve specific message
kb get-thread <message-id> # message with context
kb status # check collections and stats
kb ai # LLM-optimized schemaSet QDRANT_URL if Qdrant is not on localhost:
export QDRANT_URL=http://your-host:6333Or create a .env file:
QDRANT_URL=http://localhost:6333
EMBEDDING_MODEL=BAAI/bge-base-en-v1.5- Score 0.9+: exact topic match, 0.7-0.9: related, 0.5-0.7: partial, <0.5: filtered
- Lower
min_scoreto 0.3 for broader exploration - Use
projectparameter to filter by project (partial match), not the query - By default, thinking and tool_result content shows as
[thinking: N chars]placeholders - useinclude_thinking=True/include_tool_results=Truefor full content
git clone https://github.com/tenequm/claude-kb.git
cd claude-kb
uv sync --extra dev
just check # lint + formatMIT