ovnfs
Creates isolated, copy-on-write checkouts of any folder so agents can work without modifying the original, with diff and three-way apply to merge changes back.
At a Glance
ovnfs core CLI/daemon released under the MIT License; free to use, copy, modify and distribute.
Engagement
Available On
Alternatives
Listed Nov 2026
About ovnfs
ovnfs is an open-source command-line tool from stencil-hq, written in Go, that gives agents their own isolated, copy-on-write view of any folder, whether or not it is a git repository. The folder is opened without copying it. Users review changes with diff and merge them back with a three-way apply.
What It Is
ovnfs provides "checkouts for agents." A single daemon serves every checkout as a folder of one mount, using NFSv3 on macOS, FUSE on Linux, and SMB or WinFsp on Windows. It needs no root and no kernel extension beyond WinFsp where that is installed. Writes land in the checkout's own copy-on-write layer, so the source folder is never written until you run apply.
Workflow
From a project folder, ovnfs new starts the daemon and prints the checkout path. An agent works there, and the user inspects changes with ovnfs diff and merges them with ovnfs apply. ovnfs rm removes the checkout while its snapshots stay. Other verbs include:
runfor a disposable checkout that runs a command and is then removednew --revto start from a git revisionattach --toto open the same checkout on another machine, with content fetched lazily on first readgrepandglobfor ignore-aware searching inside the daemon
In a git repository the checkout gets a private git directory, so commits can be brought back with apply --branch NAME.
Path Classes and Limits
Every path is sorted into a class. source paths are captured and are the only bytes that leave the machine. cache and local paths such as build outputs, ignored files and secrets show the live folder read-only, and hidden paths are absent. Rules can be overridden in .o2/ovnfs.yml or with --rule, and ovnfs explain PATH shows which rule applied. ovnfs isolates files, not processes, so it is not a sandbox.
Setup Path
Install with go install, or download prebuilt binaries for Linux, macOS and Windows on amd64 and arm64. ovnfs runs git, and Linux needs fusermount3 from the fuse3 package.
Community Discussions
Be the first to start a conversation about ovnfs
Share your experience with ovnfs, ask questions, or help others learn from your insights.
Pricing
Open Source
ovnfs core CLI/daemon released under the MIT License; free to use, copy, modify and distribute.
- MIT License
- Isolated copy-on-write checkouts of any folder
- diff and three-way apply
- Snapshots, forks, and remote attach
- NFSv3 on macOS, FUSE on Linux, SMB or WinFsp on Windows
Capabilities
Key Features
- Isolated copy-on-write checkouts of any folder, git repository or not
- Review changes with diff and merge back with three-way apply
- Snapshots and forks of checkouts
- Attach checkouts to another machine with lazy content fetch
- Disposable checkouts via run
- Start checkouts from a git revision
- Path classes (source, cache, local, hidden) with configurable rules
- Private git directory per checkout with apply --branch
- Daemon-side grep and glob search
- NFSv3, FUSE, SMB and WinFsp frontends
- No root required
