Metadata-Version: 2.4
Name: ccsearch
Version: 0.2.3
Summary: Search your Claude Code sessions by content
Keywords: claude,claude-code,search,cli,transcripts,fzf
Author: Alex Yanchenko
Author-email: Alex Yanchenko <a.inbox.2026@gmail.com>
License-Expression: PolyForm-Noncommercial-1.0.0
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Project-URL: Repository, https://github.com/alex-yanchenko/ccsearch
Project-URL: Issues, https://github.com/alex-yanchenko/ccsearch/issues
Description-Content-Type: text/markdown

# ccsearch

Search your **Claude Code sessions by content** — find the chat that discussed a ticket,
PR, file, or idea weeks later, even after it drifted across topics. ccsearch reads the
actual conversation from your transcripts (never the JSON metadata) and gives you a fast
fuzzy browser with live preview and one-key resume.

## Install

```bash
brew install alex-yanchenko/tap/ccsearch   # macOS/Linux — also installs ripgrep + fzf
```

Prefer Python tooling? `uvx ccsearch` (run once) or `pipx install ccsearch` — then install
`ripgrep` and `fzf` yourself. Needs Python 3.9+.

## Use

```bash
ccsearch              # interactive browser: type to search, Enter resumes the session
ccsearch <keyword>    # list sessions mentioning <keyword>, ranked
ccsearch --index [N]  # summarize the N most-recent sessions (title + tickets)
```

In the browser: **Enter** resumes · **Ctrl-T** search mode (anywhere / one-message / exact)
· **Ctrl-S** sort (date ⇄ matches) · **Esc** quits.

Zero config — it works out of the box. The first run caches your sessions under
`~/.cache/ccsearch` (plaintext, no network; `rm -rf` it anytime to reset).

## License

[PolyForm Noncommercial 1.0.0](./LICENSE) — free for noncommercial use.
