search-sessions
Search across all your Claude Code and OpenClaw session history. Fast.
Why?
Claude Code forgets. After a few sessions, you've lost context — that clever regex, the architecture decision, the API you debugged at 2am.
Your session history is still there, buried in ~/.claude/projects/. But good luck finding anything in 1.6GB of JSONL files.
search-sessions fixes that. One binary. No indexing step. No database. Sub-second search across everything.
Each result includes the session UUID — so you can find and resume any past conversation:
❯ search-sessions "auth refactor"
[1] auth refactor discussion
Project: ~/Projects/myapp
Date: 2026-01-28 15:30
Session: 7897c935-2069-4b75-bbad-a3fac62ea59c
Resume: cd ~/Projects/myapp && claude -r 7897c935-2069-4b75-bbad-a3fac62ea59c
Just copy-paste the Resume command to pick up where you left off.
Quick Start
For Claude Code users — paste this into any session:
Set up https://github.com/sinzin91/search-sessions as a /search-sessions skill.
Claude reads the docs and handles install + setup. Then just ask to search your sessions.
Manual Install
# Homebrew (macOS/Linux)
brew install sinzin91/tap/search-sessions
# Cargo (Rust)
cargo install search-sessions
See docs/install.md for detailed instructions.
Optional: Want your agent to search history when asked "do you remember..."? Paste this:
Update your relevant files to use search-sessions when asked to remember or recall information.
Usage
This is a tool meant to be used by your agent.
# Index search (instant, searches metadata)
search-sessions "kubernetes RBAC"
# Deep search (searches full message content)
search-sessions "docker compose" --deep
# Filter by project
search-sessions "auth" --project myapp
# Filter by date range
search-sessions "deploy" --since "3 days ago"
search-sessions "auth" --since 2026-02-01 --until 2026-02-15
search-sessions "bug" --date today
search-sessions "refactor" --since "last week"
Speed
| Mode | Time |
|---|---|
| Index search | 18 ms |
| Deep search (with ripgrep) | 280 ms |
| Deep search (Rust fallback) | ~1 s |
No dependencies required. Install ripgrep for 3-5x faster deep search.
Built for Claude, not around it
Other tools give you a separate TUI or CLI to learn. This one works inside Claude — just ask:
"search my sessions for that kubernetes RBAC discussion"
No commands to memorize. No context switching.
Comparison
| Tool | Speed | Dependencies | Native to Claude |
|---|---|---|---|
| search-sessions | 280ms | None | ✅ Slash command |
| cc-conversation-search | ~500ms | Python + SQLite | ❌ |
| claude-history | ~400ms | Rust | ❌ TUI only |
| aichat claude-code-tools | ~300ms | Python + Tantivy | ❌ |
OpenClaw Support
Also searches OpenClaw agent sessions with --openclaw. See docs/openclaw.md.
Docs
License
MIT