Mem0VFS mounts the memories of one Mem0 scope, a user, an agent or a run,
read-only. Each memory is one <memory-id>.json file. Set up the API key and the scope as in Mem0 setup.
Install
Configure
agentId or runId instead of userId. host
(default https://api.mem0.ai) points at another Mem0 API host.
Fields
Seconds a request may wait to connect, or between two reads of its answer, before it fails; a download that keeps flowing is never cut off.
Authentication
The mount sends a Mem0 Platform API key, created on the dashboard’s API Keys page; the organization and project come from the key. Exactly one ofuserId, agentId and runId is set. A pair is refused: Mem0 splits a memory
added with both into separate memories, so a combined filter matches nothing.
Layout
memory, categories, metadata, created_at,
updated_at and the rest.
Behavior
- Read-only: no command changes the memories.
- Times:
statreportsupdated_at, orcreated_atwhen unset, as the modified time. - grep:
grepandrgsearch the JSON thatcatprints, so a match can come from metadata such as categories and timestamps. - Freshness: the first
lsfetches every memory in the scope, and reads reuse it until the cache expires.searchalways asks Mem0.
Search
Thesearch CLI runs Mem0’s semantic search in the
same scope. Register it on the workspace before ws.close():
--top-k defaults to defaultSearchLimit (10). --threshold is between 0 and
- Each hit prints its file and score, then the memory, ranked by score.
Browser
The sameMem0VFS runs in the browser from @struktoai/mirage-browser.
- A Mem0 API key is a secret. Never put a Platform key in a public browser bundle; a browser app calls a server-side proxy instead.
VFS.md
The VFS.md an agent reads with Mem0 mounted at/<path>.
- Rendered
- Raw
Virtual FilesystemSupported Unix Commands for VFSUnix commands work on each path as on a local filesystem, as far as the path supports them:
VFS Layout
/<path>Limitations of Unix Commands for VFSWhere a path differs from a local filesystem:
Run
man <cmd> or <cmd> --help for one command’s usage.