Weavefs

A filesystem state machine and orchestrator for Btrfs.

Features

• Recipe Snapshots: Snapshots and rolls back only paths marked as tracked in the provided recipe.
• Untracked Paths: Paths outside the tracked list are never snapshot and stay live.
• Presets: Choose one of 'tracked' variants.
• Single Volume Out of the Box: Supports only one Btrfs disk volume (subvolid=5) by default.
• Multi-Disk & Non-Btrfs: External orchestration allows using any number of disks, including non-Btrfs filesystems.
• Orchestration: Includes compact flags for easy external control.
• Fstab Generation: The tool automatically generates fstab configurations.
• SSOT: The provided recipe acts as the Single Source of Truth (SSOT).
• JSON Output: Output uses a strict JSON contract and is easy to parse.

Installation

Install the pre-compiled static binary:

sudo curl -L -o /usr/local/bin/weavefs https://github.com/ThatOneGosha/weavefs/releases/download/v2026.08.21/weavefs \
  && sudo chmod +x /usr/local/bin/weavefs

Verify the installation:

weavefs --version