RELEASE — VARN V0.3.0 · SEPTEMBER 2026

Varn: Local Filesystem Checkpointing and Safe Rollback for AI Agents and Automated Tools

Capture a known state, see exactly what changed, restore it safely — entirely offline, coexisting with Git, with machine-readable output for agents.

curl -fsSL https://raw.githubusercontent.com/flawme/varn/main/install.sh | sh

Linux · macOS · Windows — x86_64 and aarch64 · MIT OR Apache-2.0

The install script covers Linux and macOS. On Windows, grab the binary from the releases page or use cargo install.

1Highlights

Restore captures the current state first, so even a bad restore can be undone with one command.

Files modified or added since the checkpoint are flagged. Varn never silently overwrites or deletes.

Every object is re-verified against its SHA-256 before touching the disk; a pre-flight check means a restore can fail, but never halfway.

First-class --json output on every command, idempotent checkpointing, incremental scanning — and zero network calls.

Compare the target snapshot with the current filesystem; enumerate every action and conflict.

Conflicts require explicit confirmation — or the --yes flag.

Capture a safety checkpoint, then restore contents, links, and metadata.

Re-scan and confirm the filesystem matches the snapshot.

varn init
varn checkpoint "before changes"
# ... make changes ...
varn diff <checkpoint-id>
varn restore <checkpoint-id>

Listing 1 — A working session: checkpoint, observe, roll back.

Test suite	442 tests, all platforms, on every commit
Regression tree	114+ named tests — one per field-reported bug, organized by OS
Platforms	Linux, macOS, Windows — x86_64 and aarch64
Network calls	0 — no telemetry, no accounts, no cloud

varn.flawme.sbs — full technical overview, CLI reference, and safety model