layerfs

Ephemeral Workspaces, durable shared history. LayerFS gives every agent a complete, writable filesystem Workspace over shared committed history, without copying

What is layerfs?

Ephemeral Workspaces, durable shared history. LayerFS gives every agent a complete, writable filesystem Workspace over shared committed history, without copying the base. Agents work in parallel, commit what changed as deduplicated checkpoints, then branch, rewind or merge. Try it with LayerFS × DSH.

Overview of layerfs

What it is

LayerFS is a filesystem substrate that provides ephemeral workspaces with durable shared history. Each agent mounts a complete, writable workspace over shared committed history without copying the base. Agents work in parallel, commit changes as deduplicated checkpoints, and can branch, rewind, or merge. It is designed for multiagent coordination and ephemeral computing.

Key features

  • Ephemeral workspaces: each agent gets a writable filesystem workspace that is discarded after use, while history persists.
  • Durable shared history: all commits are stored as deduplicated checkpoints in an append-only store.
  • Branch, commit, merge: agents can fork branches, commit changes, and merge to main.
  • Ultra storage optimization: 157 snapshots of a real project in 100 MB, 19.9× smaller than Btrfs + zstd.
  • Instant bootstrap: dependencies come with every mount, no time lost reinstalling.
  • Conflict rules (.lww): name files that should never conflict; the newest edit wins.
  • POSIX conformance: passes 8,798 assertions with 0 unexpected failures (pjdfstest).

Use cases

LayerFS is used for agent work and history management in multiagent systems. It enables agents to fork branches, test them in sandboxes, merge, and publish. The Work and History tabs show every agent's branch live. It is suitable for scenarios requiring ephemeral compute, decentralized agents, and recursive filesystem forking.

Getting started

See the repository README for installation and quick-start instructions.

License and pricing

LayerFS is licensed under the MIT License. It is open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/ephemeral-ai-lablayerfs.svg)](https://yunodb.com/tools/ephemeral-ai-lablayerfs?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/ephemeral-ai-lablayerfs?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/ephemeral-ai-lablayerfs.svg" alt="Featured on YunoDB" height="20"></a>