icloud-escape-move

Move the tree to a plain local path like ~/code using mv for same-volume moves or ditto for cross-volume copies, then run git worktree repair on each worktree and leave a symlink at the old path. Verify all repos are clean and files are materialized first.

iCloud Desktop & Documents sync spawns conflict copies when it cannot reconcile changes inside the CloudDocs container. Git working trees are especially vulnerable because sync interferes with git's file operations, making relocation to a non-synced path the permanent fix.

iCloud's Optimize Mac Storage evicts file content, leaving dataless stubs that du reports as roughly zero bytes. Force download with brctl download, then measure true size by summing stat -f %z output across all files instead of trusting du.

Run git worktree repair inside each moved worktree to fix the parent repository's stored gitdir back-pointer. Nested worktrees are not fixed recursively, so repair each one individually and confirm with git worktree list --porcelain.

Do not use it for a normal in-volume repo move with no sync layer involved, where a plain git-aware mv is sufficient. It is specifically for trees under iCloud-managed paths showing conflict copies, evicted files, or under-reported disk usage.