--- title: "remembering-conversations by obra · skilld" canonical_url: "https://skilld.dev/gh/obra/clank" meta: description: "Searches archived Claude Code conversations by semantic similarity or exact text match to recover facts, architectural decisions, code patterns, and debugging context from past… From obra/clank." "og:description": "Searches archived Claude Code conversations by semantic similarity or exact text match to recover facts, architectural decisions, code patterns, and debugging context from past… From obra/clank." "og:title": "remembering-conversations by obra" "twitter:description": "Searches archived Claude Code conversations by semantic similarity or exact text match to recover facts, architectural decisions, code patterns, and debugging context from past… From obra/clank." "twitter:title": "remembering-conversations by obra" --- ` [All skills](https://skilld.dev/skills) [![obra avatar](https://skilld.dev/_img/avatar?url=https%3A%2F%2Fgithub.com%2Fobra.png%3Fsize%3D96)](https://skilld.dev/gh/obra) # **/remembering-conversations** [@bb6346c](https://github.com/obra/clank/commit/bb6346c39dbb4675e002a7ff679e5a4b31141d58 "Your agent reads SKILL.md at commit bb6346c") by [Jesse Vincent](https://skilld.dev/gh/obra)· [obra](https://skilld.dev/gh/obra)/ [clank](https://skilld.dev/gh/obra/clank)·41 stars 27 Search previous Claude Code conversations for facts, patterns, decisions, and context using semantic or text search - 26 files - 196.7 KB - Updated last year - [GitHub](https://github.com/obra/clank/blob/bb6346c39dbb4675e002a7ff679e5a4b31141d58/skills/collaboration/remembering-conversations/SKILL.md "View SKILL.md on GitHub") - [1 warning](#third-party-checks "Third-party checks: 1 warning · 3 checks · Risk MEDIUM") ## SKILL.md 2.1 KB **≈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](https://github.com/obra/clank/blob/bb6346c39dbb4675e002a7ff679e5a4b31141d58/skills/collaboration/remembering-conversations/SKILL.md) ## 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.](https://github.com/obra/clank/commit/bb6346c39dbb4675e002a7ff679e5a4b31141d58 "bb6346c39dbb4675e002a7ff679e5a4b31141d58") 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](https://skilld.dev/skills/testing "Bug hunting, stack traces, log analysis") - conversation-search - semantic-search - context-retrieval - claude-code - decision-tracking - architecture ## README badge ![README badge for obra/clank](https://skilld.dev/b/obra/clank?theme=light&label=0) ## 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. ## Related skills - - - - - -