> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diversion.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# worktree

> ワークツリー (リポジトリの追加のクローン) を追加、一覧表示、削除する

ワークツリーは、別のディレクトリにある、独自のワークスペースを持つ現在のリポジトリの追加のクローンです。これらのコマンドはクローン内から実行します。ワークツリーの仕組みについては、[ワークツリー](https://docs.diversion.dev/ja/basic/worktrees.md) を参照してください。

## add

```bash theme={null}
dv worktree add [path] [-b <branch>] [--ref <ref>] [--link] [--setup]
```

このリポジトリの新しいワークスペースを作成し、`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

```bash theme={null}
dv worktree list
```

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

## remove

```bash theme={null}
dv worktree remove <path> [-f]
```

ワークツリーのワークスペースを削除し、そのディレクトリの同期を停止して、ディレクトリを削除します。メインのクローンは削除しません。メインのクローンには [unregister](https://docs.diversion.dev/ja/cmd-ref/unregister.md) を使用します。

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

```
<path> has uncommitted changes or conflict backups. Commit them, clear the backups with dv conflict-backups clear, or use -f to delete them with the worktree
```

`[-f]` は、それでもワークツリーを削除し、コミットされていない変更も削除します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.