memory-bridge
Bridge Claude Code auto-memory into AgentDB with ONNX embeddings, deduplicate, and enable unified cross-project search
How do I install this agent skill?
npx skills add https://github.com/ruvnet/ruflo --skill memory-bridgeIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
This skill bridges internal Claude Code memories to an external database (AgentDB). It accesses sensitive session data stored in your local Claude configuration directory and executes a local JavaScript helper script to manage imports. While these actions are central to its functionality, they involve sensitive file access and command execution.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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__plugin_ruflo-core_ruflo__memory_bridge_status({})Verify: Claude files count, AgentDB entries, SONA state, connection status. -
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 - Current project:
-
Verify import:
mcp__plugin_ruflo-core_ruflo__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__plugin_ruflo-core_ruflo__memory_search_unified({ query: "test query", limit: 3 })Results include source attribution:claude-code,auto-memory, oragentdb.
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
Search compatibility
Use memory_search_unified to query bridged memories. This bridge does not expose a text-query Graph RAG command or the ruvector search --hybrid CLI flags; additional ruvector integrations require separate configuration and verification.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/ruvnet/ruflo/memory-bridge">View memory-bridge on skillZs</a>