Conversation History Search

VerifiedSafe

Search through past conversation histories to recall previous discussions, decisions, and context. Use to reference what was discussed or decided in earlier sessions.

Sby Skills Guide Bot
ProductivityBeginner
306/2/2026
Claude Code
#conversation-history#search#recall#context

Recommended for

Our review

Searches past conversation histories to recall previous discussions, decisions, and context.

Strengths

  • Quickly retrieves past discussions
  • Case-insensitive substring matching
  • Groups results by session for easy navigation
  • Shows timestamps and conversation context

Limitations

  • Only works with Claude Code project histories
  • Limited to ~/.claude/projects directory
  • Results truncated to 200 characters for readability
When to use it

Use when you need to recall why a decision was made or what was discussed in previous sessions.

When not to use it

Do not use when you need exact verbatim quotes or when searching across multiple projects simultaneously.

Security analysis

Safe
Quality score88/100

The skill only reads local conversation history files using a local Python script. There is no external network access, code injection, or destructive actions. The script operates on user's own data in ~/.claude/projects.

No concerns found

Examples

Find networking discussions
Search past conversations for discussions about networking using the remember skill.
Recall file discussions
Find previous conversations about DESIGN.md using the conversation history search.
Search combat system context
Look up past discussions about the combat system in my project's chat history.

name: remember description: Search through past conversation histories to recall previous discussions, decisions, and context. Use when you need to reference what was discussed or decided in previous sessions.

Conversation History Search

Search through past conversation histories stored in ~/.claude/projects/*/*.jsonl to help recall previous discussions, decisions, code explanations, and context from earlier sessions.

Instructions

  1. Run the search command with a query string:

    uv run python .claude/skills/remember/remember.py "<query>"
    
  2. Optionally include agent conversations (sub-tasks):

    uv run python .claude/skills/remember/remember.py "<query>" --include-agents
    

Features

  • Searches both user and assistant messages
  • Finds discussions about specific topics, features, or files
  • Shows conversation context with timestamps
  • Groups results by session for easy navigation
  • Sorts by recency (most recent first)
  • Skips agent conversations by default (use --include-agents to include them)
  • Case-insensitive substring matching

Examples

Search for discussions about networking:

uv run python .claude/skills/remember/remember.py "networking"

Find conversations about a specific file:

uv run python .claude/skills/remember/remember.py "DESIGN.md"

Look for combat system discussions:

uv run python .claude/skills/remember/remember.py "combat system"

Search including agent conversations:

uv run python .claude/skills/remember/remember.py "ENet" --include-agents

When to Use This Skill

  • Need to recall why a design decision was made
  • Want to find previous discussions about a feature
  • Looking for context about how something was implemented
  • Trying to remember what was decided in a past conversation
  • Need to reference code explanations from earlier sessions

Notes

  • Searches conversation histories in ~/.claude/projects/*/
  • By default, excludes agent conversations (background tasks)
  • Results are truncated to 200 characters for readability
  • Shows file path and line number for reference
  • Groups results by session to see conversation flow
  • Displays up to 50 most recent matches by default
Related skills