- name
- memory-bridge
- description
- Bridge Claude Code auto-memory into AgentDB with ONNX embeddings, deduplicate, and enable unified cross-project search
- argument-hint
- [--all-projects] [--dedupe]
- allowed-tools
- Bash Read mcp__claude-flow__memory_import_claude mcp__claude-flow__memory_bridge_status mcp__claude-flow__memory_search_unified
Memory Bridge
Import Claude Code's native auto-memory files into AgentDB for semantic search across sessions and projects.
What it does
Claude Code stores memories as markdown files in ~/.claude/projects/*/memory/*.md. This bridge:
- Reads all memory files (current project or all projects)
- Generates 384-dim ONNX embeddings (all-MiniLM-L6-v2)
- Stores in AgentDB's
claude-memoriesnamespace with HNSW indexing - Deduplicates against existing entries (cosine similarity > 0.95)
- Enables unified semantic search across all memory sources
Steps
- Check bridge health:
mcp__claude-flow__memory_bridge_status({}) Verify: Claude files count, AgentDB entries, SONA state, connection status.
- Import memories:
- Current project: mcp__claude-flow__memory_import_claude({}) - All projects: mcp__claude-flow__memory_import_claude({ allProjects: true })
CLI alternative:
node .claude/helpers/auto-memory-hook.mjs import-all- Verify import:
mcp__claude-flow__memory_bridge_status({}) Confirm entry counts match expected file counts.
- Deduplicate (if --dedupe):
Search for near-duplicate entries (cosine > 0.95) and merge them, keeping the most recent version.
- Test unified search:
mcp__claude-flow__memory_search_unified({ query: "test query", limit: 3 }) Results include source attribution: claude-code, auto-memory, or agentdb.
Auto-import
The bridge runs automatically on session-start via the SessionStart hook. Manual invocation is only needed for:
- First-time import of all projects
- After bulk memory changes outside normal sessions
- Forcing re-embedding after model updates
Integration with ruvector
When ruflo-ruvector is loaded, bridged memories are also indexed by ruvector for:
- Hybrid search (sparse + dense with RRF)
- Graph RAG multi-hop queries across memory entries
- Brain knowledge sharing across sessions