Rovo Dev CLI でワークツリー モードを使用する
ワークツリー モードを使用すると、Rovo Dev CLI をメインのチェックアウトで直接実行するのではなく、分離された Git ワークツリーで実行できます。
これは、プライマリ作業ディレクトリに影響を与えることなく、変更を分離したり、安全に試したり、後で同じワークスペースに戻ったりするのに便利です。
ワークツリー モードで Rovo Dev を起動する
コマンドライン フラグ
Git ワークツリーで Rovo Dev CLI を起動します。
# Generate a timestamp-based worktree name automatically
acli rovodev run --worktree
# Use a named worktree that you can reuse later
acli rovodev run --worktree feature-branch-cleanup値を指定せずに --worktree を渡すと、Rovo Dev では worktree-YYYYMMDD-HHMMSS の形式で名前が生成されます。
feature-branch-cleanup のような名前を渡すと、Rovo Dev では <repo>/.rovodev/worktrees/<name> の下に特定のワークツリーが作成されるか、そのワークツリーに再接続されます。
ワークツリー モードの動作
リポジトリのルートの .rovodev/worktrees/ 内で Git ワークツリーを作成または再利用します。ワークツリー モードを実行すると、Rovo Dev ではワークツリー名から派生したブランチが作成され、リポジトリの既定のリモート ブランチから開始されます。
既存のワークツリーがまだ有効な場合はそれを開くことができるため、後で同じ独立したワークスペースに戻ることができます。現在のワークスペースに未コミットの変更がある場合、Rovo Dev ではそれらを新しいワークツリーにパッチとして適用することで引き継ぎます。
さらに、ワークツリー モードではセッションがアクティブである限りロックが作成されるため、別の Rovo Dev CLI プロセスで同時に同じワークツリーを再利用することはできません。
終了とクリーンアップの動作
セッションの終了時にユーザーによる変更がない場合、Rovo Dev では自動的にワークツリーが削除されます。
インタラクティブなセッションで変更がある場合は、Rovo Dev ではワークツリーを削除するか、後で再利用するために保持するかをユーザーが選択できます。また、非インタラクティブなセッションで変更がある場合は、Rovo Dev ではワークツリーが保持され、該当する場所が報告されます。
Keeping the worktree is useful when you want to inspect changes manually, continue the same task later, or compare the isolated work to your main checkout.
追加情報
Worktree mode only works inside a Git repository.
You cannot start a new worktree session from inside another Rovo Dev worktree session.
Worktree names may only contain alphanumeric characters, hyphens, and underscores.
If a worktree is already locked by another live process, you will not be able to open that worktree in Rovo Dev CLI using the
--worktreeoption.
この内容はお役に立ちましたか?