Skip to main content
AI/MLruvnet

memory-bridge

Bridge Claude Code auto-memory into AgentDB with ONNX embeddings, deduplicate, and enable unified cross-project search

Stars
56,726
Source
ruvnet/claude-flow
Updated
2026-05-31
Slug
ruvnet--claude-flow--memory-bridge
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/ruvnet/claude-flow/HEAD/plugins/ruflo-rag-memory/skills/memory-bridge/SKILL.md -o .claude/skills/memory-bridge.md

Drops the SKILL.md into .claude/skills/memory-bridge.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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:

  1. Reads all memory files (current project or all projects)
  2. Generates 384-dim ONNX embeddings (all-MiniLM-L6-v2)
  3. Stores in AgentDB's claude-memories namespace with HNSW indexing
  4. Deduplicates against existing entries (cosine similarity > 0.95)
  5. Enables unified semantic search across all memory sources

Steps

  1. Check bridge health: mcp__claude-flow__memory_bridge_status({}) Verify: Claude files count, AgentDB entries, SONA state, connection status.

  2. 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

  3. Verify import: mcp__claude-flow__memory_bridge_status({}) Confirm entry counts match expected file counts.

  4. Deduplicate (if --dedupe): Search for near-duplicate entries (cosine > 0.95) and merge them, keeping the most recent version.

  5. 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