skilld
All skills
obra avatar

/remembering-conversations

@bb6346c
by Jesse Vincentobra/clank41 stars
27

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

Ask your Agent

Use this Skill: https://skilld.dev/gh/obra/clank/remembering-conversations

This session only. Nothing lands on disk.

SKILL.md

≈36 tokens always: the name and description. ≈415 when used: this file. ≈29k more on demand in 6 files.

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/getting-started for workflow.

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

Direct Search (Manual/CLI)

Tool: ~/.claude/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

Source: SKILL.md on GitHub

Third-party checks

1 warning4mo3 checks · Risk MEDIUM
  • Gen Agent Trust Hub4mo

    This skill provides a comprehensive system for indexing and searching past Claude conversations using semantic search and AI-generated summaries. It implements a persistence mechanism via a platform hook to automatically update its index, which is its primary functional feature. The skill uses local models for embeddings to maintain privacy while sending data to Anthropic for summarization via the official platform SDK.

  • Socket4mo

    No alerts

  • Snyk4mo

    Risk: LOW · No issues

Provenance

Signed by skilld at bb6346c. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated last year

Capability

version
1.0.0
Other metadata
when_to_use
When your human partner mentions "we discussed this before". When debugging similar issues. When looking for architectural decisions or code patterns from past work. Before reinventing solutions. When you need to find a specific git SHA or error message.

Topics

  • Debugging
  • conversation-search
  • semantic-search
  • context-retrieval
  • claude-code
  • decision-tracking
  • architecture

README badge

README badge for obra/clank

What it does

Searches archived Claude Code conversations by semantic similarity or exact text match to recover facts, architectural decisions, code patterns, and debugging context from past sessions. Use it when your human mentions "we discussed this before" or when debugging recurring issues to avoid reinventing solutions.

Generated from the current SKILL.md.

Frequently asked

How do I search conversations outside of Claude Code?
Use the CLI tool at ~/.claude/skills/collaboration/remembering-conversations/tool/search-conversations with a query string. Supports vector similarity (default), exact text match (--text flag), or both modes.
What's the difference between semantic and text search?
Semantic search finds conceptually similar conversations; text search matches exact strings like git SHAs or error messages. Use --text for precise matches and the default mode for topic-based lookups.
Can I filter search results by date?
Yes. Use --after YYYY-MM-DD and --before YYYY-MM-DD flags to narrow results to a specific time range.
When should I use this skill instead of searching the current conversation or codebase?
Search previous conversations when looking for architectural decisions, past code patterns, or context from earlier sessions. Use Grep/Read for info already in the current conversation or codebase.
Does this skill require setup?
Yes. Refer to INDEXING.md in the skill directory for initial setup instructions before using the search tool.

Generated from the current SKILL.md. These answers refresh after source changes.