vafs

A versioned agentic filesystem — durable, diffable context for long-running agents

Context

AFS defines the shape of portable agent context. vafs is what happens when you put a version history underneath it. Every mutation an agent makes to its own knowledge becomes a commit, which means you can review what an agent learned, diff two points in its history, and revert a bad ingestion without rebuilding from scratch.

SCOPE

Content-addressed storage under the AFS directory layout, so existing AFS tooling keeps working.
Every agent write is a commit with provenance: which agent, which run, which source.
Diff and revert across arbitrary points in an agent’s knowledge history.
Branching, so an agent can explore a line of work without polluting its main context.
A CLI for inspecting, pruning and exporting an agent’s accumulated context.

MY ROLE

Creator
Maintainer

TOOLS

TypeScript
Content-Addressed Storage
Agent Systems
CLI

TIMELINE

Jul 2026