Rift: лучшая альтернатива Git Worktrees с мгновенными снимками копирования при записи

Rift — это инструмент командной строки и библиотека JavaScript FFI, заменяющая Git worktrees мгновенными снапшотами с копированием при записи. На Linux используются субвольты и снапшоты btrfs; на macOS — APFS clonefile. Снапшот рабочего пространства размером 10 ГБ создается менее чем за 0,1 секунды.

Установка

npm install -g rift-snapshot
# или
bun add -g rift-snapshot

Архивы релизов доступны на GitHub.

Поддерживаемые платформы

• Linux x64: Записываемые снапшоты btrfs. rift init преобразует обычную директорию в субвол btrfs.
• macOS arm64 / x64: APFS clonefile. rift init регистрирует исходную директорию.
• Windows x64: Пакет опубликован, но создание рабочего пространства пока не реализовано.

Использование CLI

Инициализация в корне проекта:

cd ~/code/app
rift init

rift init выбирает ближайший корень Git. Используйте --here, чтобы принудительно указать точную директорию. На Linux происходит преобразование в субвол btrfs с импортом reflink.

Создание снапшота рабочего пространства:

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

Новое рабочее пространство имеет отсоединенный HEAD в репозитории Git, сохраняя индекс и рабочее дерево.

Просмотр и управление:

rift list
rift ancestors
rift remove
rift gc

rift remove перемещает рабочее пространство в соседнюю папку .trash. rift gc физически удаляет перемещенные данные.

Интеграция с оболочкой

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

Это автоматически изменяет директорию после init, create или remove.

Структура хранения

~/code/app/           # исходное рабочее пространство
~/code/.rifts/app/parser-fix/  # созданное рабочее пространство
~/code/.rifts/app/.trash/      # удаленное рабочее пространство

Каждое управляемое рабочее пространство содержит маркер .rift; реестр SQLite отслеживает пути и родительские элементы.

JavaScript API

Поддерживает Bun и Node.js (требуется Node 26.1+ с --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();

Функции: init, create, remove, list, ancestors, gc. Опции включают at, name, into, database.

Rift является экспериментальным — API могут изменяться. Работает только на Linux и macOS.