Skip to main content
ワークツリーは、別のディレクトリにある、独自のワークスペースを持つ現在のリポジトリの追加のクローンです。これらのコマンドはクローン内から実行します。ワークツリーの仕組みについては、ワークツリー を参照してください。

add

このリポジトリの新しいワークスペースを作成し、path にクローンします。path、-b、--ref のうち少なくとも 1 つを指定してください。 [path] はワークツリーを作成する場所です。my-task のような単一の名前を指定すると、現在のクローンの隣に diversion-worktrees/<repo>/my-task が作成されます。パスを現在のクローンの内部にすることはできません。-b または --ref を指定しない場合、ワークツリーはパスの最後の部分と同じ名前のブランチ上に置かれ、そのブランチが存在しなければ現在のコミットから作成されます。-b または --ref を指定してパスを指定しない場合、ディレクトリ名はブランチ名またはコミットに基づいて付けられます。 [-b <branch>] は、--ref または現在のコミットから、ワークツリー用の新しいブランチを作成します。ブランチが存在する場合は失敗します。 [--ref <ref>] は、ブランチ名、ブランチ ID、コミット ID、またはタグ ID をチェックアウトします。-b と一緒に指定した場合は、新しいブランチの開始点になります。 [--link] は、リポジトリの .dvworktree.yml で link: の下に列挙されたディレクトリを現在のクローンからシンボリックリンクします。これにより、ワークツリーは独自にビルドする代わりにそれらを共有します。 [--setup] は、リポジトリの .dvworktree.yml にある setup: のコマンドを新しいワークツリーで実行します。コマンドは、現在のクローンのパスを環境変数 DV_WORKTREE_ORIGIN で受け取ります。信頼できるリファレンスでのみ使用してください。

list

このコンピューター上にあるこのリポジトリのワークツリーを、パス、ブランチ、ワークスペース ID とともに一覧表示します。

remove

ワークツリーのワークスペースを削除し、そのディレクトリの同期を停止して、ディレクトリを削除します。メインのクローンは削除しません。メインのクローンには unregister を使用します。 -f を指定しない場合は、最初にワークツリーを再スキャンして同期を待ちます。その後、ワークツリーにコミットされていない変更、競合、競合バックアップ、サブモジュールがある場合、またはワークツリーが一時停止中の場合は、削除を拒否します。変更とバックアップの場合のエラーは次のとおりです:
[-f] は、それでもワークツリーを削除し、コミットされていない変更も削除します。