How zilliztech/memsearch works
MemSearch provides shared semantic memory for coding agents: plugins capture conversation turns into Markdown journals, the CLI indexes those files and serves search/expansion, and agents reuse recalled context across platforms. The runtime also includes transcript-based retrieval, live synchronization, optional reranking, durable-note maintenance, and memory-to-skill distillation. Core call edges use the supplied source index; plugin workflows and unsampled capabilities are included only where the README documents them.
Main entry points: cli.py CLI commands · core.py Memory orchestrator · io.py Markdown journals · index.ts OpenCode plugin
Components 21
Agent integrations
- Claude Code plugin
plugins/claude-code - Codex plugin
plugins/codex - DSH plugin
plugins/dsh - OpenClaw plugin
plugins/openclaw - OpenCode plugin
plugins/opencode/index.ts
Memory runtime
- Markdown journals
src/memsearch/io.py - CLI commands
src/memsearch/cli.py - Configuration
src/memsearch/config.py - Memory orchestrator
src/memsearch/core.py
Recall and indexing
- File scanner
src/memsearch/scanner.py - Markdown chunker
src/memsearch/chunker.py - Embedding providers
src/memsearch/embeddings/__init__.py - Milvus index
src/memsearch/store.py - Live file watcher
src/memsearch/watcher.py - Hybrid reranking
src/memsearch/reranker.py - Jev reranker
src/memsearch/jev_reranker.py - Transcript recall
src/memsearch/transcript.py
Memory evolution
- Memory compaction
src/memsearch/compact.py - Durable-note maintenance
src/memsearch/maintenance.py - Skill distillation
src/memsearch/skills.py
Other components
- Coding agents
Connections 30
- Coding agents → Claude Code plugin: uses
README.md - Coding agents → Codex plugin: uses
README.md - Coding agents → DSH plugin: uses
README.md - Coding agents → OpenClaw plugin: uses
README.md - Coding agents → OpenCode plugin: uses
README.md - Claude Code plugin → Markdown journals: captures turns
README.md - Codex plugin → Markdown journals: captures turns
README.md - DSH plugin → Markdown journals: captures turns
README.md - OpenClaw plugin → Markdown journals: captures turns
README.md - OpenCode plugin → Markdown journals: captures turns
README.md - Coding agents → CLI commands: runs recall
README.md - CLI commands → Configuration: loads settings
src/memsearch/cli.py - CLI commands → Memory orchestrator: invokes indexing
src/memsearch/cli.py - CLI commands → Milvus index: reads and expands
src/memsearch/cli.py - CLI commands → Transcript recall: provides transcript recall
README.md - Memory orchestrator → File scanner: scans files
src/memsearch/core.py - Memory orchestrator → Markdown chunker: chunks content
src/memsearch/core.py - Memory orchestrator → Embedding providers: creates vectors
src/memsearch/core.py - Memory orchestrator → Milvus index: stores and searches
src/memsearch/core.py - Memory orchestrator → Live file watcher: starts watching
src/memsearch/core.py - Memory orchestrator → Hybrid reranking: reranks results
src/memsearch/core.py - Hybrid reranking → Jev reranker: dispatches Jev
src/memsearch/reranker.py - OpenCode plugin → CLI commands: runs memory commands
plugins/opencode/index.ts - OpenCode plugin → Markdown journals: reads recent context
- CLI commands → Memory compaction: offers compaction
src/memsearch/cli.py - CLI commands → Durable-note maintenance: runs maintenance
src/memsearch/cli.py - CLI commands → Skill distillation: manages skills
src/memsearch/cli.py - Durable-note maintenance → Memory compaction: uses compaction
src/memsearch/maintenance.py - Durable-note maintenance → Markdown journals: maintains notes
README.md - Skill distillation → Markdown journals: distills workflows
README.md