Rift: Eine bessere Alternative zu Git Worktrees mit sofortigen Copy-on-Write-Snapshots

Rift ist ein Kommandozeilen-Tool und eine JavaScript-FFI-Bibliothek, die Git-Worktrees durch sofortige Copy-on-Write-Snapshots ersetzt. Unter Linux verwendet es btrfs-Subvolumes und -Snapshots, unter macOS APFS-Clonefiles. Ein 10-GB-Arbeitsbereichs-Snapshot dauert unter 0,1 Sekunden.

Installation

npm install -g rift-snapshot
# oder
bun add -g rift-snapshot

Release-Archive sind auf GitHub verfügbar.

Unterstützte Plattformen

• Linux x64: Beschreibbare btrfs-Snapshots. rift init wandelt ein normales Verzeichnis in ein btrfs-Subvolume um.
• macOS arm64 / x64: APFS-Clonefiles. rift init registriert das Quellverzeichnis.
• Windows x64: Paket veröffentlicht, aber Workspace-Erstellung noch nicht implementiert.

CLI-Nutzung

Initialisieren Sie im Projektstammverzeichnis:

cd ~/code/app
rift init

rift init wählt das nächste Git-Stammverzeichnis aus. Verwenden Sie --here, um das genaue Verzeichnis zu erzwingen. Unter Linux wird es mit Reflink-Import in ein btrfs-Subvolume umgewandelt.

Erstellen Sie einen Workspace-Snapshot:

rift create --name parser-fix
rift create --into /fast/rifts

Der neue Workspace hat einen detached HEAD in einem Git-Repo und bewahrt Index und Arbeitsverzeichnis.

Auflisten und verwalten:

rift list
rift ancestors
rift remove
rift gc

rift remove verschiebt den Workspace in einen benachbarten .trash-Ordner. rift gc löscht gelöschte Daten physisch.

Shell-Integration

eval "$(rift shell-init zsh)"
# oder bash

Dies wechselt das Verzeichnis automatisch nach init, create oder remove.

Speicherlayout

~/code/app/           # Quell-Workspace
~/code/.rifts/app/parser-fix/  # erstellter Workspace
~/code/.rifts/app/.trash/      # entfernter Workspace

Jeder verwaltete Workspace hat eine .rift-Markierung; eine SQLite-Datenbank verfolgt Pfade und Eltern.

JavaScript-API

Unterstützt Bun und Node.js (erfordert Node 26.1+ mit --experimental-ffi).

import { create, list, remove, gc } from 'rift-snapshot';

const workspace = create({ from: process.cwd(), name: 'schema-work' });
console.log(list({ of: process.cwd() }));
remove({ at: workspace });
gc();

Funktionen: init, create, remove, list, ancestors, gc. Optionen umfassen at, name, into, database.

Rift ist experimentell – APIs können sich ändern. Funktioniert vorerst nur unter Linux und macOS.