mcpField
M
memory-bridge

memory-bridge

github.com/ruvnetAgent workflows80.1k744 installsUpdated today
Repository

About memory-bridge

memory-bridge is a skill for importing Claude Code auto-memory files into AgentDB and searching them semantically across sessions and projects. It supports deduplication and can also index bridged memories through ruvector when loaded.

Key features

  1. 01Import memories from one or all projects
  2. 02Generate ONNX embeddings
  3. 03Store and deduplicate entries in AgentDB
  4. 04Search across memory sources
  5. 05Automatic import at session start

Use cases

  1. 01Bring existing Claude Code memories into AgentDB
  2. 02Search memories across projects and sessions
  3. 03Remove near-duplicate memory entries

MCP support

Uses Ruflo MCP tools to check bridge status, import memories, and run unified search.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ruvnet/ruflo --skill memory-bridge

After installing, type/memory-bridgein Claude Code to confirm it loaded.

Details

From the project README

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__plugin_ruflo-core_ruflo__memory_bridge_status({}) Verify: Claude files count, AgentDB entries, SONA state, connection status.

  2. Import memories:

    • Current project: mcp__plugin_ruflo-core_ruflo__memory_import_claude({})
    • All projects: mcp__plugin_ruflo-core_ruflo__memory_import_claude({ allProjects: true })

    CLI alternative:

    node .claude/helpers/auto-memory-hook.mjs import-all

  3. Verify import: mcp__plugin_ruflo-core_ruflo__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__plugin_ruflo-core_ruflo__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

Comments

Markdown supported