memory-lens
Reviewed
at commit 8b5dac8
New version, not yet reviewed
Recalls the few memories related to each prompt: one line for the human, one context entry for the model. Local files only, no network on the hot path.
0 upvotes
Log in to upvote or save- Made by
- Yonatan Gross
- Pinned commit
-
8b5dac89295dd8060cb338398725cff89a762607 - What we checked
-
Matches each prompt you type against your Claude memory files for this project and adds the titles, descriptions and paths of up to three related memories to what Claude receives, plus one line on screen. It reads only local files, never sends data elsewhere and writes nothing. Memories that look like credentials or client data are hidden on screen or left out.
Review details
Static review of the source at the pinned commit; not run. Hooks: session.start (builds an in-memory BM25 index in the background and registers the /memory-lens command), prompt.submit (queries before next(e) and appends one context string, skipped for automated or slash-command prompts; waits at most 2 seconds for the first index), tool.call (only for Write or Edit whose file_path is under the memory folder, to re-read that one file) and command.run for /memory-lens (stats, reload, show n). Runtime calls: $.env.get('HOME'), $.fs.list and $.fs.read on ~/.claude/projects/<project key>/memory/*.md (a worktree maps to its parent repo), optionally ~/.claude/memory-lens/private.json (client keywords) and ~/.claude/memory-lens/mirror-<key>.json (titles written by a private job outside the mod), $.clock.after, $.ui.log and $.command.register. Context carries the memory name, a description of at most 240 characters and the file path; the body is only used for matching. Items whose name, description, id, source or image path match a credential-shaped regex are dropped from context and shown as locked on screen, and client memories show no title on screen. All errors are swallowed and the prompt goes through unchanged. No process, http or store calls. If HOME is unset (Windows) the memory folder resolves to a relative path and nothing is found. The pre-scan process hits are regex exec calls, not programs. npm dependencies: none (dev-only test tools).
- What it uses
-
- Reads your prompts: yes
- Sees tool calls: yes
- Blocks or changes tool calls: no
- Reads or writes files: yes
- Runs programs on your machine: no
- Calls the model (uses tokens): no
- Sends data over the network: no
- Stores data: no
- Shows something on screen: yes
Recalls the few memories related to each prompt you send (never on automated turns or file tool calls): one line for the human, one context entry for the model. Local files only, no network on the hot path.
Made this mod? Add a badge to your README
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/memory-lens/)