remembering-conversations
Search previous Claude Code conversations for facts, patterns, decisions, and context using semantic or text search
When & Why to Use This Skill
The Remembering Conversations skill empowers Claude Code users to perform high-precision semantic and text-based searches across historical conversation archives. By indexing past interactions, it serves as a long-term memory layer that allows developers to instantly retrieve critical facts, architectural decisions, and debugging patterns, ensuring project continuity and significantly reducing redundant effort in AI-assisted coding workflows.
Use Cases
- Recalling Architectural Decisions: Quickly locate the rationale behind previous design choices to ensure consistency when implementing new features or refactoring code.
- Accelerated Debugging: Search for past discussions regarding similar error logs or edge cases to reuse proven fixes and avoid reinventing solutions.
- Context Retrieval: Find specific code snippets, Git SHAs, or project requirements mentioned in earlier sessions that are no longer present in the current conversation context.
- Pattern Recognition: Identify established coding patterns and project-specific conventions by searching how similar tasks were handled in previous interactions.
- Knowledge Continuity: Seamlessly resume complex tasks by retrieving the 'state of mind' and specific decisions made during prior development phases.
| name | Remembering Conversations |
|---|---|
| description | Search previous Claude Code conversations for facts, patterns, decisions, and context using semantic or text search |
| when_to_use | when partner mentions past discussions, debugging familiar issues, or seeking historical context about decisions and patterns |
| version | 1.1.0 |
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