memsearch
Shared semantic memory for agents: conversations are saved as markdown and recalled by search across Claude Code, Codex and other agents
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Writes conversation content into local markdown files and a vector index
- By default sends text to an external embedding service unless a local model is chosen, and runs background memory maintenance
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/memsearchDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run one by one in the Claude Code chat
/plugin marketplace add zilliztech/memsearch
/plugin install memsearch@memsearch-pluginsInstall the plugin: /plugin marketplace add zilliztech/memsearch, then /plugin install memsearch, and restart the agent. For local, keyless use run pip install "memsearch[local]" and the local embedding provider.
Other ways from the author
/plugin marketplace add zilliztech/memsearch
/plugin install memsearchRestart Claude Code after installing.
This is third-party code. Review the repository files before installing.
What it does
memsearch gives agents long-term memory that is shared across tools. The plugin automatically records the flow of a conversation into markdown files and returns the relevant piece on request through semantic search. Plain .md files are the source of truth, while the Milvus vector index is treated as a derived cache that can be rebuilt at any time. Search is hybrid: dense vectors, sparse BM25 and reranking, with hash-based dedup and real-time file watching. It installs as a plugin for Claude Code, Codex, DeepSeek Harness, OpenClaw and OpenCode, and for custom use there is a CLI and a Python API from the memsearch package. Embeddings can come from a cloud provider or a local model with no key.
Who it is for. For developers and engineers who want memory that survives sessions and is shared between different agents.
Good fit when
- You want the agent to remember decisions and context between sessions
- You want one shared memory across several agents, for example Claude Code and Codex
- You need semantic search over your own markdown notes from a CLI or code
Not a fit when
- Manual notes in a project file are enough, without an index or background processes
- You cannot send conversation content to an external embedding service and cannot run a local model
Example request
We discussed Redis caching before, what TTL did we choose back thenLimitations
It needs Python 3.10 or newer. By default embeddings run through OpenAI, which is not reachable from Russia without a VPN, but there are local providers with no key: ONNX, Ollama and sentence-transformers, which work offline. The default store is a local Milvus Lite, and a remote Milvus is also supported. The plugin writes conversation content into files and an index, and background memory maintenance is a separate set of tasks that you enable deliberately.
How to disable. Remove the memsearch plugin via /plugin and restart the agent. For Codex and other platforms remove the plugin from the profile with the matching command. The index and markdown memory live in the .memsearch directory and are deleted separately.
Security check
- Writes conversation content into local markdown files and a vector index
- By default sends text to an external embedding service unless a local model is chosen, and runs background memory maintenance
README in short
The README presents memsearch as cross-platform semantic memory for agents: markdown is the source of truth and Milvus serves as the index. Users install a plugin and get automatic conversation capture and recall, while developers use a CLI and Python API. It documents installation for Claude Code, Codex, DeepSeek Harness, OpenClaw and OpenCode, the choice of embedding provider including keyless local ones, and a keyless quick start on Milvus Lite. It also mentions three-layer recall, hybrid search and hash-based dedup, plus distilling repeated workflows into installable skills. MIT license, by Zilliz.
FAQ
Where is memory stored?
In plain markdown files in the .memsearch directory, which are the source of truth. The Milvus index is a derived cache rebuilt from those files.
Can I avoid a cloud key?
Yes. There are local embedding providers, ONNX, Ollama and sentence-transformers, and the Milvus Lite store, all running on your own machine.
Related
Open-source personal AI assistant on your own machine: answers in Telegram, Slack, Discord and WhatsApp, extended with skills and plugins
A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself
An open source coding agent for the terminal and desktop with build and plan modes
Open prompt library with a Claude Code plugin, MCP server and CLI: search, fetch and improve prompts and skills from an agent