search-sessions
By sinzin91
Search past Claude Code and OpenClaw session history by metadata for instant results or full message content for deeper matches. Retrieve conversations, decisions, and code snippets with project details, dates, summaries, and UUIDs to resume sessions directly. Filter by project, agent name, or result limit.
npx claudepluginhub sinzin91/search-sessions --plugin search-sessionsComponent Overview
Component Details
README
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
Similar Plugins
qrec
qrec session recall engine
Help us improve
Share bugs, ideas, or general feedback.