Rift: インスタントコピーオンライトスナップショットによるGitワークツリーのより良い代替

Riftは、Gitの作業ツリーをインスタントなコピーオンライトスナップショットに置き換えるコマンドラインツールおよびJavaScript FFIライブラリです。Linuxではbtrfsサブボリュームとスナップショット、macOSではAPFS clonefileを使用します。10GBのワークスペーススナップショットは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では、reflinkインポートでbtrfsサブボリュームに変換します。

ワークスペーススナップショットを作成:

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

新しいワークスペースはGitリポジトリでHEADがデタッチされ、インデックスとワーキングツリーが保持されます。

一覧と管理:

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のみで動作します。