# Memory Recall

Search and recall relevant memories from past sessions via MemSearch.

- Repository: https://github.com/zilliztech/memsearch (2815 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-10-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add zilliztech/memsearch --skill memory-recall -g -a claude-code -y`
Codex: `npx skills add zilliztech/memsearch --skill memory-recall -g -a codex -y`
Cursor: `npx skills add zilliztech/memsearch --skill memory-recall -g -a cursor -y`
Gemini CLI: `npx skills add zilliztech/memsearch --skill memory-recall -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add zilliztech/memsearch`

## Description

Search and recall relevant memories from past sessions via MemSearch. Use for past decisions, debugging notes, previous conversations, and project knowledge, especially when the context includes a MemSearch memory hint. Skip purely current-code questions or when the user asks to ignore memory.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Search memories relevant to the user's current question. The plugin's tools resolve the requesting session's checkout and configured collection, and recover pending capture before recall.

## Steps

1. Use `memory_search` with a concrete query and `top_k: 5`. It returns text containing a JSON array of objects with `chunk_hash`, `content` and `source`. When calling through `execute`, return the search result and inspect its text before selecting hashes. Evaluate relevance before expanding results.
2. Use `memory_get` with the most promising `chunk_hash` values to read full Markdown sections.
3. For claims requiring original dialogue, use `memory_transcript` with `session_id`, `turn_id` and `db_path` from the expanded `session:` / `turn:` / `db:` anchor. Set `context: 3`; for an anchor without a turn, use `limit: 10`.
   - If OpenCode transcript lookup fails after an upgrade, distinguish an incompatible host/plugin pair, an unavailable database or session/turn, and an incomplete V1-to-V2 database migration. See [OpenCode diagnostics](../memory-config/references/opencode.md), also used by `memory-config`. Check the referenced conversation only; a lookup failure does not justify scanning unrelated transcripts.
   - Keep existing markdown and `session:` / `turn:` / `db:` anchors unchanged. Return useful search/expand results with the L3 limitation stated. If host migration is needed, direct the user to OpenCode's migration guidance; do not migrate the database or rewrite anchors during recall. Do not describe a summary as verified original dialogue.

4. Return a concise account of relevant facts with dates and source files. Distinguish journal summaries from verified dialogue. If nothing relevant is found, say so.

The rest: https://github.com/zilliztech/memsearch/blob/HEAD/plugins/opencode/skills/memory-recall/SKILL.md