Skip to main content
The RAM VFS exposes an in-memory filesystem mounted at some prefix such as /data/. All data lives in process memory and is lost on exit. No setup or credentials required.

Config

No configuration object needed - RAMVFS() takes no arguments.

Filesystem Layout

The RAM filesystem starts empty. Files and directories are created on demand via commands like touch, mkdir, tee, cp, etc.
Paths are normalized with a leading /. The root directory / always exists.

Cache

The RAM VFS uses IndexCacheStore with index_ttl = 0, so its listings are not cached: the data is in memory, and every listing reads it. A workspace index: block still applies its ttl to this mount; see index TTL.

Example

Shell Commands

The RAM VFS supports the full set of shell commands since it handles real file content (text, binary, JSON, CSV, etc.):

Read Commands

Text Processing

File Operations

Path Utilities

Compression

Encoding

Use Cases

  • Testing: Fast filesystem for unit tests without I/O
  • Staging: Temporary data area during pipelines
  • Prototyping: Develop against a filesystem before switching to S3/disk
  • Caching: In-process data exchange between commands
  • Ephemeral workspaces: Create, process, discard - no cleanup needed