Rift: Una Mejor Alternativa a Git Worktrees con Instantáneas Instantáneas Copy-on-Write

Rift es una herramienta de línea de comandos y una biblioteca FFI de JavaScript que reemplaza los worktrees de Git con instantáneas instantáneas copy-on-write. En Linux, usa subvolúmenes e instantáneas de btrfs; en macOS, clonefile de APFS. Una instantánea de un espacio de trabajo de 10 GB tarda menos de 0.1 segundos.

Instalación

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

Los archivos de lanzamiento están disponibles en GitHub.

Plataformas compatibles

• Linux x64: Instantáneas de btrfs con escritura. rift init convierte un directorio normal en un subvolumen btrfs.
• macOS arm64 / x64: Clonefile de APFS. rift init registra el directorio de origen.
• Windows x64: Paquete publicado pero la creación de espacios de trabajo aún no implementada.

Uso CLI

Inicializa en la raíz de tu proyecto:

cd ~/code/app
rift init

rift init elige la raíz de Git más cercana. Usa --here para forzar el directorio exacto. En Linux, lo convierte en un subvolumen btrfs con importación reflink.

Crea una instantánea del espacio de trabajo:

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

El nuevo espacio de trabajo tiene HEAD separado en un repositorio Git, preservando el índice y el árbol de trabajo.

Lista y gestiona:

rift list
rift ancestors
rift remove
rift gc

rift remove mueve el espacio de trabajo a una carpeta .trash adyacente. rift gc elimina físicamente los datos en la papelera.

Integración con el shell

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

Esto cambia de directorio automáticamente después de init, create o remove.

Estructura de almacenamiento

~/code/app/           # espacio de trabajo origen
~/code/.rifts/app/parser-fix/  # espacio de trabajo creado
~/code/.rifts/app/.trash/      # espacio de trabajo eliminado

Cada espacio de trabajo gestionado tiene un marcador .rift; un registro SQLite rastrea rutas y padres.

API JavaScript

Compatible con Bun y Node.js (requiere Node 26.1+ con --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();

Funciones: init, create, remove, list, ancestors, gc. Las opciones incluyen at, name, into, database.

Rift es experimental — las APIs pueden cambiar. Funciona solo en Linux y macOS por ahora.