LangfuseVFS mounts one Langfuse project as read-only files: its traces with
their observations and scores, sessions, prompt versions and datasets. Set up the key pair as in Langfuse setup.
Install
Configure
defaultTraceLimit sets how many traces a listing shows, and
defaultFromTimestamp lists only traces from an ISO 8601 time on.
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.
Langfuse API host; override for a self-hosted or regional instance.
The most traces one trace listing (
traces/ or a session’s traces) shows. An older trace is still readable by its id.List only traces from this ISO 8601 timestamp on. Unset lists whatever the project holds, up to
defaultTraceLimit.Authentication
The mount reads with a project’s key pair, the public key (pk-lf-...) and
the secret key (sk-lf-...), and sees only that project. host is the
project’s region, such as https://cloud.langfuse.com (EU) or
https://us.cloud.langfuse.com (US), or a self-hosted URL. The mount reads
the Langfuse v4 API, so a self-hosted instance must run Langfuse v4.
Layout
traces/: one.jsonfile per trace: the trace’s root observation, with its other observations (spans, generations, events) inobservationsand its scores inscores.inputandoutputare the strings Langfuse stores;jq '.input | fromjson'parses a JSON one.sessions/: the sessions of the tracestraces/lists, each holding its own traces.prompts/: one folder per prompt name, one file per version (1.json,2.json) with the prompt content and metadata.datasets/: one folder per dataset, withitems.jsonl(its items) andruns/, one.jsonlfile per experiment run.
Behavior
- Read only: no command changes Langfuse.
- Trace limit:
traces/lists up todefaultTraceLimittraces (100), fromdefaultFromTimestampon. The cap bounds the listing, not the tree:statandcatstill reach an older trace by its id, andsessions/<id>/serves only that session’s traces. - Search:
grepandrgread each file ascatrenders it. Langfuse has no content search, sogrep -rovertraces/reads every trace the listing returns. - No counts: Langfuse has no count endpoint, so
wc -l traces/is not supported.
Browser
The browserLangfuseVFS from @struktoai/mirage-browser takes the same fields.
- The secret key reaches the page, so anyone who loads it can read the project.
VFS.md
The VFS.md an agent reads with Langfuse 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.