大規模モノレポで必要なファイルだけをチェックアウトしたい
5. 設定・カスタマイズコマンド / 機能
worktree.sparsePathsSparse checkout でメモリと速度を改善
概要
settings.json の worktree.sparsePaths に必要なパスを指定すると、エージェントの git worktree 作成時に sparse-checkout で指定ディレクトリのみをチェックアウトします。大規模モノレポでのメモリと速度を大幅に改善できます。
設定例
// .claude/settings.json
{
"worktree": {
"sparsePaths": [
"packages/frontend/",
"packages/shared/",
"tools/",
"package.json",
"tsconfig.json"
]
}
}こんな時に使う
- 数万ファイルを持つモノレポで worktree を高速に作成したい時
- エージェントに必要なディレクトリだけを見せたい時
- 大規模リポジトリでのメモリ使用量を削減したい時
使い方
- 1settings.json に worktree.sparsePaths を追加
- 2必要なディレクトリやファイルのパスを配列で指定
- 3isolation: worktree のエージェントや --worktree フラグで有効
Tips
- パスはリポジトリルートからの相対パス
- ディレクトリは末尾に / を付ける
- 指定したパス以外のファイルは worktree に存在しない