エージェントクイックスタート

このページは AI コーディングエージェント (Claude Code、Cursor、Codex、あるいはシェルコマンドを実行する任意のツール) 向けに書かれています。dv CLI を使って Diversion をリポジトリのバージョン管理として利用する方法を説明します。Diversion はクラウドネイティブのバージョン管理システムで、Git や Perforce の代替であり、大きなバイナリファイルと自動同期のために作られています。 Diversion が向いているケース: リポジトリに Git や Git LFS がうまく扱えない大きなファイルまたはバイナリファイル (ゲームアセット、モデル、データセット、ビルド成果物) がある場合、コミットを push や pull なしにチームメイトへ自動同期させたい場合、または複数のエージェントを走らせていてそれぞれにリポジトリの独立したコピーが必要な場合です。デスクトップアプリで自分で Diversion をセットアップしていますか? 代わりにクイックスタートから始めてください。

エージェントをここに向けさせますか? 完全な機械可読なドキュメントインデックスは docs.diversion.dev/llms.txt にあります (完全なテキストは /llms-full.txt)。そのURLをこのページと一緒にエージェントに渡してください。

Diversion と Git の違い

Diversion は Git ではありません。コマンドを実行する前に、以下のルールを理解してください:

自動同期 — push も pull もない。 各コミットは自動的にクラウドとチームメイトにレプリケートされます。dv push や dv pull はありません。
ステージングエリアなし — git add なし。 Diversion はワーキングツリーのあらゆる変更を継続的に追跡します。ファイルを直接コミットします。
1 ワークスペース = 1 ワーキングディレクトリ。 ワークスペース は単一のブランチのローカルコピーです。2 つのブランチで同時に作業するには、2 つのワークスペースを使います — エージェントを並列に実行を参照してください。
常にサブコマンドを渡す。 dv status、dv commit などを実行します。裸の dv を実行するとインタラクティブシェルが開きます。非対話またはエージェントコンテキストでは避けてください。

インストール

macOS / Linux
Windows

curl -sL https://get.diversion.dev/unix | bash ; export PATH="$HOME/.diversion/bin:$PATH"

export PATH の行をシェルプロファイル (~/.bashrc または ~/.zshrc) に追加すると永続化されます。

インストールを確認します:

dv version

認証

dv login

これによりサインインのためブラウザが開きます。エージェントが動作する環境で、人間が一度これを実行し、以降はエージェントがそのセッションを再利用します。

ヘッドレスまたは CI エージェント (ブラウザなし): API トークンを生成し (Web アプリで avatar → Integrations、次に Settings → Integrations ページで Generate a new API token)、dv authenticate <token> で非対話的に認証します — ブラウザは不要です。完全なセットアップは CI/CD ガイドを参照してください。同じトークンは REST API への Bearer トークンとしても機能します。API アクセスには Pro プラン以上が必要です。

コアコマンド

# Start tracking a new project in the current directory
dv init

# Get a working copy of an existing repository
dv clone <repo> [path]

# See what changed in the working tree
dv status

# Commit all current changes (replicates automatically — no push needed)
dv commit -a -m "your message"

# Create a new branch and switch to it
dv branch -c <branch-name>

# Switch to an existing branch, commit, or tag
dv checkout <ref>

# Merge another branch into the current one
dv merge <branch>

# View history
dv log

完全なリファレンス: CLI リファレンス。

Git → Diversion コマンドマップ

Git	Diversion (`dv`)
`git clone <url>`	`dv clone <repo> [path]`
`git init`	`dv init`
`git add <files>`	(不要 — 変更は自動的に追跡されます)
`git status`	`dv status`
`git commit -am "msg"`	`dv commit -a -m "msg"`
`git push` / `git pull`	(不要 — 自動同期)
`git checkout -b <name>`	`dv branch -c <name>`
`git switch <name>`	`dv checkout <name>`
`git merge <name>`	`dv merge <name>`
`git log`	`dv log`
`git worktree add <path> <branch>`	`dv clone <repo> <path> --new-workspace --ref <branch>`

エージェントを並列に実行する

エージェントを独立したワークスペースで実行する場合 — Diversion における git worktree に相当します — リポジトリを独立したディレクトリにクローンし、それぞれ専用のブランチ で独自のワークスペースを持たせます。ワークスペースはディスク上で独立しており、エージェントごとの専用ブランチによって、それらのコミットが干渉し合わないようになります。(ブランチを共有するエージェントは依然として自動同期し、競合する可能性があります — 各エージェントに独自のブランチを与えてください。)

# Create an isolated workspace on a dedicated branch
dv clone <repo> /tmp/<repo>-agent-1 --new-workspace --ref <branch>

エージェントは /tmp/<repo>-agent-1 内で作業し、通常どおりコミットします — 変更はそのブランチに自動同期されます。作業が完了したら、ワークスペースを取り除きます:

dv workspace            # list workspaces to find the one to remove (id starts with dv.ws.)
dv unregister -f        # run from inside /tmp/<repo>-agent-1 — detaches the local copy
dv workspace delete <workspace-id> -f
rm -rf /tmp/<repo>-agent-1

現状では、これはバイナリアセットを含めてリポジトリ全体をクローンします。アセットの多いリポジトリ (例: Unreal プロジェクト) では、ワークスペースごとに大きなダウンロードとなります。CLI からのコード限定 (「選択同期」) クローンはロードマップにあります。

次のステップ

エージェントの推論を記録する

Diversion の Claude Code 用プラグインは、各コミットをそれを生み出した会話にリンクします。あとからなぜその変更が行われたかを尋ねられます。オプションです。

CLI リファレンス

すべての dv コマンド、フラグ、引数。

API リファレンス

REST 経由で Diversion を自動化します。

SlothBot

Diversion に組み込まれた AI コーディングエージェント。

Get Started

AI

Collaborate

Work with Unreal Engine

Work with Unity

Integrations

Reference

CLI Reference

エージェントクイックスタート

Diversion と Git の違い

インストール

認証

コアコマンド

Git → Diversion コマンドマップ

エージェントを並列に実行する

次のステップ

エージェントの推論を記録する

CLI リファレンス

API リファレンス

SlothBot

​Diversion と Git の違い

​インストール

​認証

​コアコマンド

​Git → Diversion コマンドマップ

​エージェントを並列に実行する

​次のステップ

エージェントの推論を記録する

CLI リファレンス

API リファレンス

SlothBot

Diversion と Git の違い

インストール

認証

コアコマンド

Git → Diversion コマンドマップ

エージェントを並列に実行する

次のステップ