Rift : Une meilleure alternative aux worktrees Git avec des instantanés instantanés par copie sur écriture

Rift est un outil en ligne de commande et une bibliothèque FFI JavaScript qui remplace les worktrees Git par des snapshots instantanés en copy-on-write. Sous Linux, il utilise les sous-volumes et snapshots btrfs ; sous macOS, clonefile APFS. Un snapshot d'espace de travail de 10 Go prend moins de 0,1 seconde.

Installation

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

Les archives de version sont disponibles sur GitHub.

Plateformes supportées

• Linux x64 : snapshots btrfs accessibles en écriture. rift init convertit un répertoire ordinaire en sous-volume btrfs.
• macOS arm64 / x64 : clonefile APFS. rift init enregistre le répertoire source.
• Windows x64 : paquet publié mais la création d'espace de travail n'est pas encore implémentée.

Utilisation en CLI

Initialisez dans la racine de votre projet :

cd ~/code/app
rift init

rift init choisit la racine Git la plus proche. Utilisez --here pour forcer le répertoire exact. Sous Linux, il le convertit en sous-volume btrfs avec import reflink.

Créez un snapshot d'espace de travail :

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

Le nouvel espace de travail a un HEAD détaché dans un dépôt Git, préservant l'index et l'arbre de travail.

Listez et gérez :

rift list
rift ancestors
rift remove
rift gc

rift remove déplace l'espace de travail vers un dossier .trash adjacent. rift gc supprime physiquement les données mises à la corbeille.

Intégration shell

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

Cela change automatiquement de répertoire après init, create ou remove.

Structure de stockage

~/code/app/           # espace de travail source
~/code/.rifts/app/parser-fix/  # espace de travail créé
~/code/.rifts/app/.trash/      # espace de travail supprimé

Chaque espace de travail géré a un marqueur .rift ; une base SQLite enregistre les chemins et les parents.

API JavaScript

Support de Bun et Node.js (nécessite Node 26.1+ avec --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();

Fonctions : init, create, remove, list, ancestors, gc. Options incluent at, name, into, database.

Rift est expérimental — les API peuvent changer. Fonctionne seulement sur Linux et macOS pour l'instant.