session-search

Search through historical Claude sessions for code, conversations, and commands. Use when user asks about previous sessions, past conversations, "did I ever", "find in history", or wants to retrieve code/info from earlier chats.

$ Installer

git clone https://github.com/atondwal/config /tmp/config && cp -r /tmp/config/.claude/skills/session-search ~/.claude/skills/config

// tip: Run this command in your terminal to install the skill


name: session-search description: Search through historical Claude sessions for code, conversations, and commands. Use when user asks about previous sessions, past conversations, "did I ever", "find in history", or wants to retrieve code/info from earlier chats.

Session Search

Search through your Claude session history stored in ~/.claude/projects/.

Usage

Run the search script with a regex or keyword pattern:

python ~/.claude/skills/session-search/search.py "pattern" [max_results]

Examples

# Find sessions mentioning a specific function
python ~/.claude/skills/session-search/search.py "def parse_config"

# Find discussions about a topic
python ~/.claude/skills/session-search/search.py "kubernetes|docker"

# Find code with specific imports
python ~/.claude/skills/session-search/search.py "from fastapi import"

# Limit results
python ~/.claude/skills/session-search/search.py "error" 10

Output

Returns matches with:

  • Session slug/ID and project path
  • Timestamp
  • Role (user/assistant)
  • Matching content with surrounding context
  • 1 message before/after for context

Results are sorted by recency (newest first), limited to 20 by default.