BeClaude

search-sessions

New
8Community RegistryDevelopmentby sinzin91

Search across Claude Code and OpenClaw session history

Community PluginView Source

Overview

search-sessions

Overview

Fast CLI to search across all Claude Code and OpenClaw session history. Find past decisions, code snippets, and resume any previous session.

Announce at start: "I'm using search-sessions to find that in your session history."

When to Use

  • User asks about something from a previous session
  • Need to find past decisions, code, or context
  • User wants to resume a previous conversation
  • Searching for "that thing we discussed" or similar

Installation

bash
# Homebrew (macOS/Linux)
brew install sinzin91/tap/search-sessions

# Cargo (Rust)
cargo install search-sessions

# From source
git clone https://github.com/sinzin91/search-sessions
cd search-sessions && cargo build --release

Usage

Index Search (default, instant)

Searches session metadata — summaries, first prompts, project paths.

bash
search-sessions "kubernetes RBAC"
search-sessions "auth migration" --project myapp

Deep Search (full-text)

Searches actual message content. Use --deep flag.

bash
search-sessions "docker compose" --deep
search-sessions "that regex for parsing" --deep

OpenClaw Sessions

Search OpenClaw agent sessions with --openclaw.

bash
search-sessions "security audit" --openclaw

Resume a Session

Results include the session UUID. User can resume with:

bash
claude --resume <session-uuid>

Output Format

code
============================================================
  INDEX SEARCH: "kubernetes"
  3 matches found
============================================================

  [1] Kubernetes RBAC configuration
      Project:  ~/Projects/myapp
      Date:     2026-01-28 15:30
      Session:  7897c935-2069-4b75-bbad-a3fac62ea59c

  [2] ...

Options

FlagDescription
--deepSearch full message content (slower)
--openclawSearch OpenClaw sessions instead of Claude Code
--project FILTERFilter to projects matching substring
--limit NMax results (default: 20)
--agent NAMEOpenClaw agent to search (default: main)

Tips

  • Start with index search (no flags) — it's instant
  • Use --deep only if index search doesn't find it
  • Include project filter to narrow results
  • Present session UUID so user can resume if needed

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/search-sessions.md https://raw.githubusercontent.com/sinzin91/search-sessions/main/SKILL.md
3
Invoke in Claude Code
/search-sessions
View source on GitHub

Frequently Asked Questions

What is search-sessions?

Search across Claude Code and OpenClaw session history

How to install search-sessions?

To install search-sessions, create the .claude/skills directory in your project, then run the curl command to download the skill file. Once installed, invoke it in Claude Code with /search-sessions.

What is search-sessions best for?

search-sessions is a community categorized under Development. Created by sinzin91.