Rift: Uma Alternativa Melhor para Git Worktrees com Snapshots Instantâneos de Copy-on-Write

Rift é uma ferramenta de linha de comando e biblioteca JavaScript FFI que substitui Git worktrees por snapshots instantâneos com copy-on-write. No Linux, usa subvolumes e snapshots btrfs; no macOS, clonefile APFS. Um snapshot de workspace de 10GB leva menos de 0,1 segundo.

Instalação

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

Arquivos de release estão disponíveis no GitHub.

Plataformas Suportadas

• Linux x64: Snapshots btrfs graváveis. rift init converte um diretório comum em um subvolume btrfs.
• macOS arm64 / x64: APFS clonefile. rift init registra o diretório de origem.
• Windows x64: Pacote publicado, mas a criação de workspace ainda não foi implementada.

Uso via CLI

Inicialize na raiz do seu projeto:

cd ~/code/app
rift init

rift init escolhe a raiz Git mais próxima. Use --here para forçar o diretório exato. No Linux, converte para um subvolume btrfs com importação reflink.

Crie um snapshot do workspace:

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

O novo workspace possui HEAD destacado em um repositório Git, preservando o índice e a árvore de trabalho.

Liste e gerencie:

rift list
rift ancestors
rift remove
rift gc

rift remove move o workspace para uma pasta .trash adjacente. rift gc exclui fisicamente os dados descartados.

Integração com Shell

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

Isso muda o diretório automaticamente após init, create ou remove.

Estrutura de Armazenamento

~/code/app/           # workspace de origem
~/code/.rifts/app/parser-fix/  # workspace criado
~/code/.rifts/app/.trash/      # workspace removido

Cada workspace gerenciado tem um marcador .rift; um registro SQLite rastreia caminhos e pais.

API JavaScript

Suporta Bun e Node.js (requer Node 26.1+ com --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();

Funções: init, create, remove, list, ancestors, gc. Opções incluem at, name, into, database.

Rift é experimental — as APIs podem mudar. Funciona apenas em Linux e macOS por enquanto.