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