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
agent_id or run_id instead of user_id. 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 ofuser_id, agent_id and run_id 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, structured_attributes and the rest:
Behavior
- Read-only: no command changes the memories.
- Times:
statreportsupdated_at, orcreated_atwhen unset, as the modified time, and shows both. - grep:
grepandrgsearch the JSON thatcatprints, so a match can come from metadata such as categories and timestamps. Plaingrepneeds-ror a glob on the mount;rgrecurses by default. - Freshness: the first
lsfetches every memory in the scope, and reads reuse it until the cache expires.searchalways asks Mem0. - Snapshots: a snapshot keeps the config, and loading it needs the mount
handed back through
mounts=.
Search
Thesearch CLI runs Mem0’s semantic search in the same
scope. Register it on the workspace before ws.close():
--top-k defaults to default_search_limit (10). --threshold is between 0
and 1. Each hit prints its file and score, then the memory, ranked by score:
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.