ccsearch

Full-text, BM25-ranked search over your entire Claude Code history — then jump back into any conversation in one keystroke.

CI Release MIT Stars

ccsearch demo: searching Claude Code sessions and resuming one

Why

claude --resume only lists AI-generated titles. If you don't recognize the title, you're stuck. ccsearch indexes the full text of every session — your prompts, Claude's replies, the commands it ran, the files it touched, even subagent transcripts — and ranks matches with BM25. Search by what actually happened.

Features

🔎 Full-text, not titles

Every message, tool call, and file path in your history is searchable.

🏆 BM25 ranking

SQLite FTS5 with title-weighted scoring surfaces the right session first.

↩️ Instant resume

Pick a result; your shell jumps into the project dir and resumes — and stays there.

🀄 Chinese / CJK aware

A custom bigram analyzer makes 2-character queries work where plain FTS5 can't.

🧠 Semantic recall

-e expands your query with related terms when you can't recall the exact words.

⚡ Single binary

SQLite compiled in. Sub-50ms warm search. macOS, Linux, Windows; zsh/bash/fish/PowerShell.

Install

# Cargo (any platform)
cargo install ccsearch

# Homebrew (macOS / Linux)
brew install yaalsn/tap/ccsearch

# Or download a prebuilt binary from Releases, then enable shell integration:
eval "$(ccs init zsh)"   # or bash / fish / powershell

Then just ccs <what you remember>. Full docs on GitHub.

100% local & private

Indexing and search run entirely on your machine — your sessions never leave. Semantic mode sends only the short query text, never any conversation content.