Skip to main content
GeneralBbgnsurfTech

Remembering Conversations

Search previous Claude Code conversations for facts, patterns, decisions, and context using semantic or text search

Stars
18
Source
BbgnsurfTech/claude-skills-collection
Updated
2025-12-18
Slug
BbgnsurfTech--claude-skills-collection--remembering-conversations
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/BbgnsurfTech/claude-skills-collection/HEAD/community/superpowers-skills/skills/collaboration/remembering-conversations/SKILL.md -o .claude/skills/remembering-conversations.md

Drops the SKILL.md into .claude/skills/remembering-conversations.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Remembering Conversations

Search archived conversations using semantic similarity or exact text matching.

Core principle: Search before reinventing.

Announce: "I'm searching previous conversations for [topic]."

Setup: See INDEXING.md

When to Use

Search when:

  • Your human partner mentions "we discussed this before"
  • Debugging similar issues
  • Looking for architectural decisions or patterns
  • Before implementing something familiar

Don't search when:

  • Info in current conversation
  • Question about current codebase (use Grep/Read)

In-Session Use

Always use subagents (50-100x context savings). See skills/using-skills for workflow.

Manual/CLI use: Direct search (below) for humans outside Claude Code sessions.

Direct Search (Manual/CLI)

Tool: ${SUPERPOWERS_SKILLS_ROOT}/skills/collaboration/remembering-conversations/tool/search-conversations

Modes:

search-conversations "query"              # Vector similarity (default)
search-conversations --text "exact"       # Exact string match
search-conversations --both "query"       # Both modes

Flags:

--after YYYY-MM-DD    # Filter by date
--before YYYY-MM-DD   # Filter by date
--limit N             # Max results (default: 10)
--help                # Full usage

Examples:

# Semantic search
search-conversations "React Router authentication errors"

# Find git SHA
search-conversations --text "a1b2c3d4"

# Time range
search-conversations --after 2025-09-01 "refactoring"

Returns: project, date, conversation summary, matched exchange, similarity %, file path.

For details: Run search-conversations --help