ruflo-rag-memory

Reviewed at commit 13af5f1

Caution: Its skills pre-approve Bash and have Claude run the unpinned npm package @claude-flow/cli@latest through npx, so each new version runs without asking.

RuVector memory with HNSW search, AgentDB, and semantic retrieval. As a mod (ADR-445): a write guard that keeps secrets out of memory, /rag-mod, and a status…

Made by
ruvnet
What we checked

Refuses writes to the Ruflo memory tools that hold a key, token or password, and adds a /rag-mod command that shows counters and checks text for secrets. Writes the counters to a small status file in your project. Its hook makes no network calls and runs no programs; the skills can also import Claude Code's own memory files into AgentDB.

Review details

Static review of the source at the pinned commit; not run. Delta review of the changes since 87d8687; the rest carries over from the review at that commit. The new version changes no hook code: it adds a repository field, bumps the version and rewords step 3 of the memory-search skill so the agentdb_context-synthesize call is only for questions about earlier task episodes. The module registers session.start (reads the project root, registers /rag-mod, writes the status file), tool.call and command.run for /rag-mod. tool.call counts calls to the plugin's memory tools and, when the guard option is on, scans every string in the input of the writer tools (memory_store, memory_import, agentdb_hierarchical-store, agentdb_pattern-store) with regex secret rules and returns a deny with a rule-free message when something matches; oversized input is refused. The status file .claude-flow/rag-mod/status.json holds counters and the last blocked tool name, rewritten at most every 5 seconds; write errors are swallowed. No fetch, process or model calls in the hook code. The prompt files add two commands, an agent and two skills (memory-bridge, memory-search) that pre-approve Bash and tell Claude to run npx @claude-flow/cli@latest memory search/store/list/delete, hooks worker dispatch and hooks post-task; user query text is to be single-quote escaped and newlines rejected. memory-bridge imports Claude Code auto-memory files (~/.claude/projects/*/memory/*.md, optionally all projects) into the local AgentDB with embeddings through the ruflo-core MCP server, and lists node .claude/helpers/auto-memory-hook.mjs import-all as a CLI alternative, which runs a script from the opened project. The ruflo-core MCP server and the @claude-flow/cli package were not reviewed.

What it uses
  • Reads your prompts: no
  • Sees tool calls: yes
  • Blocks or changes tool calls: yes
  • Reads or writes files: yes
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events

RuVector memory with HNSW search, AgentDB, and semantic retrieval. As a mod (ADR-445): a write guard that keeps secrets out of memory, /rag-mod, and a status file the console shows

Made this mod? Add a badge to your README

modsforClaude badge for ruflo-rag-memory

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/ruflo-rag-memory.svg)](https://modsforclaude.com/mods/ruflo-rag-memory/)

← All mods