memory-bridge — Claude Code skill: unified memory search
Bridges Claude Code's auto-memory files into AgentDB with semantic search across all projects. Deduplicates entries and enables unified cross-project memory queries.
npx skills add ruvnet/ruflo --skill memory-bridge -a claude-codeWhat memory-bridge does
The skill reads markdown memory files from ~/.claude/projects/*/memory/ and converts them to 384-dimensional ONNX embeddings. Entries land in the claude-memories namespace with HNSW indexing for fast semantic retrieval. Deduplication runs on cosine similarity above 0.95—automatically merges near-duplicates and keeps the most recent version.
The bridge activates on session-start via the SessionStart hook, so new memories flow into AgentDB without manual steps. Check status with mcp__plugin_ruflo-core_ruflo__memory_bridge_status—it shows Claude file counts, AgentDB entries, and connection state. Search works via mcp__plugin_ruflo-core_ruflo__memory_search_unified and attributes each result to its source.
The skill requires Node.js and a local AgentDB instance. Start by verifying the bridge, then import your current project or all projects with the --all-projects flag.
What it helps with
- find a note from another project by meaning, not filename
- merge memories from multiple sessions into one searchable index
- remove duplicates in accumulated memory
- share context between projects via unified search
Example prompts for the agent
- Check bridge status and how many entries are already in AgentDB
- Import memories from all projects and deduplicate with --dedupe flag
- Search for where I mentioned this bug—use semantic search across projects
How to install memory-bridge
1Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill memory-bridge -a claude-code2Manually: put the files in place
~/.claude/skills/memory-bridge/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/memory-bridge/
1Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill memory-bridge -a codex2Manually: put the files in place
.agents/skills/memory-bridge/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill memory-bridge -a cursor2Manually: put the files in place
.cursor/skills/memory-bridge/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ruvnet/ruflo memory-bridge2Manually: put the files in place
.github/skills/memory-bridge/SKILL.md1Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill memory-bridge -a gemini-cli2Platform CLI
gemini skills install https://github.com/ruvnet/ruflo --path plugins/ruflo-rag-memory/skills/memory-bridgeManually: put the files in place
.devin/skills/memory-bridge/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill memory-bridge -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set104
The whole set →Similar
Questions about memory-bridge
How do I install memory-bridge in Claude Code?
Run npx skills add ruvnet/ruflo --skill memory-bridge -a claude-code, then check ~/.claude/skills/memory-bridge/SKILL.md. For other platforms, swap the flag: -a codex for Codex, -a cursor for Cursor, -a gemini-cli for Gemini CLI.
What does memory-bridge do?
It bridges Claude Code's memory files into AgentDB with ONNX embeddings, deduplicates entries by similarity above 0.95, and enables semantic search across all your projects via a single command.
Can I search memory from one project only, or does it search everything?
Import can be scoped to the current project (command without flags) or expanded to all projects with --all-projects. Search runs across all imported entries together; source attribution is included in results.
Source text
SKILL.md · MIT
---
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__plugin_ruflo-core_ruflo__memory_import_claude mcp__plugin_ruflo-core_ruflo__memory_bridge_status mcp__plugin_ruflo-core_ruflo__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:
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:
```bash
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
## 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.
© ruvnet · MIT · ruvnet/ruflo
