作業を失わず worktree lifecycle を管理する

Mutation 前に作成と inventory

grok worktree create NAME は grok -w と同じ方法で worktree を作りますが、session は開始しません。--ref がなければ HEAD と uncommitted changes から始まるため、clean な base が必要なら --ref を渡します。

grok worktree list --json で inventory し、複数 project があれば repo で絞ります。Grok Build 1.0.67 の一覧には registry の worktree、未完了の copy、Grove clone が含まれます。worktree show で exact ID/path を確認し、grok du --json で ~/.grok と worktree の disk 使用量を確認します。

Worktree 内の Git status、untracked files、branch、HEAD、unpushed commits を確認します。

grok worktree create fix-auth --ref origin/main
grok worktree list --json
grok worktree show ID_OR_PATH
grok du --json

Removal/GC を preview

worktree rm は複数 ID と --dry-run を受け付けます。gc も --dry-run を持ちますが、--max-age がなければ何も期限切れにせず、作業が他に残らない worktree は保持します。--max-age 7d --dry-run で idle sweep を preview し、mutation 直前に candidate を再確認します。

Dirty/unpushed work を保全する前に --force を使いません。rm では process、開いている session、未保存の作業があっても削除し、gc では live-process、open-session、protected-path の guard を飛ばします。Age だけでは obsolete と判断できません。

Exact ID を使用。
必要なら diff/commit を保存。
Cleanup 後に re-list。

grok worktree gc --max-age 7d --dry-run
grok worktree rm --dry-run ID

Database を分離

db stats/path は metadata、db rebuild は filesystem scan で tracking database を再構築します。Git history は変更しません。

Tracking が誤っている時だけ rebuild し、scan roots を review します。

Grove clone と recovery を明示的に扱う

Grok Build 1.0.67 の release help には Grove 系 command が加わりました。grok clone は Grove（macOS は NFS、Linux は FUSE）で repository を lazy clone し、--full-history を付けない限り高速な depth-1 bootstrap です。grok worktree detach は Grove-projected worktree を通常の git worktree に変換し、rm --keep-store は Grove clone を unmount して登録を外しつつ store を disk に残します。

Source repository が消えた場合、grok worktree salvage と --out で hydrated/dirty files を通常の repository として回収します。clean-artifacts は git clean が消さない escape-directory artifact を削除し、--yes は取り消せないため先に --dry-run で一覧します。Redirect の add、del、fixup、unmount の前に worktree redirect list で確認します。

Source repository が消えた worktree は削除前に salvage。
clean-artifacts --yes と grok du --clean は取り消せない削除として扱う。
公式 worktrees ページは Grove を記載していません。これらは release help の情報です。

grok worktree redirect list MOUNT --json
grok worktree clean-artifacts ID_OR_PATH --dry-run
grok worktree salvage ID_OR_PATH --out ../recovered