{"code":"var Component=(()=>{var u=Object.create;var r=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var m=Object.getPrototypeOf,f=Object.prototype.hasOwnProperty;var y=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports),b=(t,e)=>{for(var n in e)r(t,n,{get:e[n],enumerable:!0})},s=(t,e,n,a)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let o of g(e))!f.call(t,o)&&o!==n&&r(t,o,{get:()=>e[o],enumerable:!(a=p(e,o))||a.enumerable});return t};var w=(t,e,n)=>(n=t!=null?u(m(t)):{},s(e||!t||!t.__esModule?r(n,\"default\",{value:t,enumerable:!0}):n,t)),k=t=>s(r({},\"__esModule\",{value:!0}),t);var h=y((F,l)=>{l.exports=_jsx_runtime});var v={};b(v,{default:()=>c});var i=w(h());function d(t){let e={a:\"a\",code:\"code\",em:\"em\",h2:\"h2\",h3:\"h3\",img:\"img\",li:\"li\",ol:\"ol\",p:\"p\",pre:\"pre\",span:\"span\",strong:\"strong\",ul:\"ul\",...t.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"iCloud Drive auto-download bug in macOS Tahoe 26.4 hero\",src:\"/images/blog/icloud-drive-auto-download-bug-macos-tahoe-26-4-fix-2026/hero.webp\",width:\"2848\",height:\"1504\"})}),`\n`,(0,i.jsxs)(e.p,{children:[\"You open your \",(0,i.jsx)(e.code,{children:\"~/Documents\"}),\" folder in Finder, scroll past a few files, and notice something odd: every single item \\u2014 hundreds of PDFs, Keynote decks, photos, archives \\u2014 is suddenly downloading. Not the one you double-clicked. \",(0,i.jsx)(e.em,{children:\"All of them.\"}),\" The little cloud icons turn into download arrows, your fan starts spinning, and your menubar Wi-Fi indicator lights up. By the time you realize what is happening, your 256 GB MacBook Air has eaten 40 GB of your iCloud library, and your hotspot data plan has cratered.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"This is the bug that has dominated Apple Community threads since macOS Tahoe 26.4 shipped in late March 2026. It affects users who rely on \",(0,i.jsx)(e.strong,{children:\"Optimize Mac Storage\"}),\" \\u2014 the very feature that is supposed to keep iCloud Drive lightweight on disk by leaving rarely-used files in the cloud. After 26.4, simply \",(0,i.jsx)(e.em,{children:\"browsing\"}),\" a folder is enough to trigger a full local download of its contents, defeating the entire purpose of the feature.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"Apple has not acknowledged the bug publicly as of this writing. There is no release-note line item, no hotfix, no AppleSeed ticket the average user can file results against. What we do have is a growing pile of reproductions on \",(0,i.jsx)(e.a,{href:\"https://discussions.apple.com/thread/256273434\",children:\"Apple Discussions thread 256273434\"}),\", Reddit, and developer forums \\u2014 plus four workarounds that actually reduce the damage while we wait for 26.5.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"This article walks through what is happening, why it is probably happening, and how to keep your bandwidth and SSD intact in the meantime.\"}),`\n`,(0,i.jsx)(e.h2,{id:\"key-takeaways\",children:\"Key Takeaways\"}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"The bug\"}),\": After macOS Tahoe 26.4 (and the follow-up 26.4.1), navigating into an iCloud Drive folder in Finder triggers downloads of every file inside, even if \",(0,i.jsx)(e.strong,{children:\"Optimize Mac Storage\"}),\" is enabled.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Who is affected\"}),\": Anyone using iCloud Drive with Optimize Mac Storage on. The damage is worst for users with small SSDs (128 GB / 256 GB MacBooks) and metered connections (hotspot, cellular, capped home plans).\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Suspected cause\"}),\": A regression in the file-coordination layer used by \",(0,i.jsx)(e.code,{children:\"bird\"}),\" (the CloudDocs daemon) and Finder's QuickLook prefetch \\u2014 files that were previously hydrated only on read are now hydrated on directory enumeration.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Workarounds available today\"}),\": Toggle Optimize Mac Storage off and back on, manually evict downloaded files with the \",(0,i.jsx)(e.code,{children:\"brctl evict\"}),\" Terminal command, disable Optimize Mac Storage entirely and live with full local copies, or use iCloud.com for selective access.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Long-term fix\"}),\": Community testers report partial improvement in macOS 26.5 beta 4, with general availability expected late May 2026. Apple has not formally confirmed the fix.\"]}),`\n`]}),`\n`,(0,i.jsx)(e.h2,{id:\"what-users-are-actually-seeing\",children:\"What Users Are Actually Seeing\"}),`\n`,(0,i.jsx)(e.p,{children:\"Before we get into causes, let us be precise about the symptom because there are several adjacent iCloud bugs floating around and they are easy to confuse.\"}),`\n`,(0,i.jsx)(e.p,{children:\"The reported behavior, consistent across multiple reports on the Apple Discussions thread:\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[\"User has \",(0,i.jsx)(e.strong,{children:\"System Settings \\u2192 Apple Account \\u2192 iCloud \\u2192 iCloud Drive \\u2192 Optimize Mac Storage\"}),\" turned \",(0,i.jsx)(e.strong,{children:\"on\"}),\".\"]}),`\n`,(0,i.jsx)(e.li,{children:\"Files in iCloud Drive that have not been opened recently show the small cloud-with-down-arrow badge in Finder, indicating they are stored remotely.\"}),`\n`,(0,i.jsxs)(e.li,{children:[\"User opens a folder in Finder \\u2014 for example \",(0,i.jsx)(e.code,{children:\"~/iCloud Drive/Documents/Invoices/2024/\"}),\" \\u2014 that contains, say, 200 PDFs.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[\"Within seconds, \",(0,i.jsx)(e.em,{children:\"every\"}),` file in that folder begins downloading. Finder's status bar shows a cumulative progress bar (\"Downloading 200 items, 4.2 GB of 12.8 GB\"). The cloud badges flip to blue progress rings.`]}),`\n`,(0,i.jsx)(e.li,{children:\"If the user navigates into a subfolder, the same thing happens recursively.\"}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"Finder showing simultaneous download progress on many iCloud Drive files\",src:\"/images/blog/icloud-drive-auto-download-bug-macos-tahoe-26-4-fix-2026/finder-download-progress.webp\",width:\"2848\",height:\"1504\"})}),`\n`,(0,i.jsx)(e.p,{children:`This is not the normal \"fetch a thumbnail for QuickLook\" behavior that Finder has always done. Thumbnail fetches were small (kilobytes per file at most) and did not change the file's \"stored locally\" state. The 26.4 behavior fully hydrates the file \\u2014 meaning the entire payload lands on disk and counts against your local storage.`}),`\n`,(0,i.jsxs)(e.p,{children:[\"A handful of users on the thread report that the bug \",(0,i.jsx)(e.strong,{children:\"does not always trigger immediately\"}),\". Sometimes it kicks in when Spotlight indexing touches the folder. Sometimes it happens only when a Finder column-view preview pane is open. Sometimes it happens only after the Mac has been idle and \",(0,i.jsx)(e.code,{children:\"bird\"}),\" runs a maintenance pass. The trigger is inconsistent, which is part of what makes the bug hard to confirm and harder to file a clean bug report for.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"What is consistent is the outcome: files that should have remained as cloud placeholders end up fully downloaded.\"}),`\n`,(0,i.jsx)(e.h2,{id:\"why-this-matters-more-than-it-sounds\",children:\"Why This Matters More Than It Sounds\"}),`\n`,(0,i.jsx)(e.p,{children:\"If you have a 2 TB Mac Studio on Gigabit fiber, this is annoying but not catastrophic. For everyone else, the bug is genuinely painful.\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Storage pressure on small SSDs.\"}),\" Apple still ships 256 GB as the base configuration on most consumer Macs. A 200 GB iCloud library that hydrates aggressively will fill the disk in minutes. Once disk usage crosses ~90 percent, macOS itself begins to misbehave \\u2014 Spotlight rebuilds fail, swap thrashes, app launches slow down, and the system may forcibly evict cached files in unpredictable order.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Bandwidth bills on metered connections.\"}),\" A startling number of Mac users work from coffee shops, coworking spaces, hotels, or rural homes where bandwidth is metered or capped. A single accidental browse of a Photos library backup folder can blow through a month's data allowance in an afternoon. Cellular hotspot users are particularly exposed because there is no warning before the download begins.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Backup chaos.\"}),` If you use Time Machine or a third-party clone tool, every newly-hydrated file is now a \"changed\" file from the backup tool's perspective. Your next backup run becomes massive \\u2014 sometimes terabytes \\u2014 even though nothing meaningful has changed about the content. We discuss the backup angle further in our `,(0,i.jsx)(e.a,{href:\"/blog/best-mac-backup-strategy-2026-time-machine-icloud-clone\",children:\"Mac backup strategy guide\"}),\".\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Battery and thermals.\"}),\" Continuous downloads keep the Wi-Fi radio active and the SSD writing constantly. On laptops, this measurably reduces runtime and can trigger thermal throttling on fanless models like the MacBook Air.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"In short, this is one of those bugs where the underlying defect is small but the downstream cost is large.\"}),`\n`,(0,i.jsx)(e.h2,{id:\"confirming-you-have-the-bug\",children:\"Confirming You Have the Bug\"}),`\n`,(0,i.jsx)(e.p,{children:\"Before applying any workaround, take five minutes to confirm the bug is actually what is happening on your Mac. The symptoms can be confused with normal iCloud sync after a fresh login, or with the deliberate hydration that happens when an app like Spotlight or Backup tries to read a file.\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Test procedure:\"})}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Open System Settings \\u2192 General \\u2192 Storage. Note your current free disk space.\"}),`\n`,(0,i.jsxs)(e.li,{children:['Open Activity Monitor \\u2192 Network tab. Sort by \"Bytes Received\" descending. Note the current value for ',(0,i.jsx)(e.code,{children:\"bird\"}),\" (the CloudDocs daemon process).\"]}),`\n`,(0,i.jsxs)(e.li,{children:[\"In Terminal, run \",(0,i.jsx)(e.code,{children:\"brctl status\"}),\" and confirm Optimize Mac Storage is enabled.\"]}),`\n`,(0,i.jsx)(e.li,{children:\"Open Finder and navigate to an iCloud Drive folder you have not visited in at least a week. Choose one with many files (50+) of meaningful size (1 MB+ each).\"}),`\n`,(0,i.jsx)(e.li,{children:\"Wait 60 seconds. Do not click any individual file.\"}),`\n`,(0,i.jsxs)(e.li,{children:[\"Return to Activity Monitor. Has \",(0,i.jsx)(e.code,{children:\"bird\"}),\" received hundreds of MB or more?\"]}),`\n`,(0,i.jsx)(e.li,{children:\"Return to Storage settings. Has free disk space dropped noticeably?\"}),`\n`,(0,i.jsx)(e.li,{children:\"Back in Finder, look at the file badges. Have cloud icons been replaced with progress rings or fully removed?\"}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:\"If the answer to questions 6, 7, and 8 is yes \\u2014 and you did not click any file \\u2014 you are seeing the bug.\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"If you want a more rigorous trace, you can run \",(0,i.jsx)(e.code,{children:\"brctl monitor com.apple.CloudDocs\"}),\" in a Terminal window before step 4. You will see live events for every file \",(0,i.jsx)(e.code,{children:\"bird\"}),\" decides to materialize. Under normal behavior in older macOS releases, only files you explicitly opened would generate \",(0,i.jsx)(e.code,{children:\"materialize\"}),\" events. Under the 26.4 bug, you will see materialize events firing for every file in the directory you just opened, in rapid succession.\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"root-cause-what-probably-changed-in-264\",children:\"Root Cause: What Probably Changed in 26.4\"}),`\n`,(0,i.jsx)(e.p,{children:\"Here is where we have to be honest about what is and is not known.\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"Apple has not published anything about this regression. The clearest signal from the developer-facing release notes for 26.4 is that the \",(0,i.jsx)(e.strong,{children:\"file-coordination layer\"}),' received changes related to \"improvements to iCloud Drive responsiveness\" \\u2014 that exact wording, with no further detail. Community speculation, based on careful observation of ',(0,i.jsx)(e.code,{children:\"bird\"}),\" log output, suggests two related changes:\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"First\"}),\", the prefetch heuristic that Finder uses to populate column-view previews and icon-view thumbnails appears to have been broadened. Previously, Finder asked \",(0,i.jsx)(e.code,{children:\"bird\"}),\" for \",(0,i.jsx)(e.em,{children:\"metadata\"}),\" \\u2014 file size, modification date, thumbnail \\u2014 for each visible file, and \",(0,i.jsx)(e.code,{children:\"bird\"}),\" returned that without hydrating the full file. Under 26.4, the thumbnail subsystem appears to be requesting full file content for any file type where the thumbnail generator might need to examine the body \\u2014 which in practice means almost everything: PDFs, images, videos, Office docs, even some plain text files.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Second\"}),\", the eviction policy that normally re-offloads files to the cloud after a period of disuse has become much less aggressive. Files that should be evicted within hours are sticking around for days. This means that even if you trigger the bug just once, the damage compounds: the disk fills up faster than \",(0,i.jsx)(e.code,{children:\"bird\"}),\" is willing to clean up.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"Both observations are consistent with what users report: the trigger is folder navigation (because that is when Finder asks for thumbnails) and the damage persists (because nothing is evicting the files afterwards).\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"We want to flag clearly: \",(0,i.jsx)(e.strong,{children:\"this is community-derived speculation, not an official cause analysis\"}),\". It is consistent with the symptoms but Apple has not confirmed it. If you are filing a Feedback Assistant report, describe the symptoms you observed, not the speculated cause.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"For broader context on how iCloud Drive sync is supposed to work in Tahoe, our \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-icloud-drive-complete-guide-2025\",children:\"iCloud Drive complete guide\"}),\" covers the normal architecture. The current bug is a deviation from the documented behavior described there.\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"workaround-1-toggle-optimize-mac-storage-off-then-on\",children:\"Workaround 1: Toggle Optimize Mac Storage Off Then On\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"This is the lowest-effort fix and works for some \\u2014 \",(0,i.jsx)(e.em,{children:\"some\"}),\" \\u2014 users. It does not address the underlying bug, but it appears to reset the prefetch state in \",(0,i.jsx)(e.code,{children:\"bird\"}),\" and buys you a temporary reprieve.\"]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Steps:\"})}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Open System Settings \\u2192 Apple Account (your name at the top) \\u2192 iCloud.\"}),`\n`,(0,i.jsx)(e.li,{children:\"Click iCloud Drive in the list of apps using iCloud.\"}),`\n`,(0,i.jsxs)(e.li,{children:[\"Toggle \",(0,i.jsx)(e.strong,{children:\"Optimize Mac Storage\"}),\" off. Wait for the spinner to settle. macOS may warn that local copies will be downloaded \\u2014 in this case ignore the warning because we will toggle back before that completes.\"]}),`\n`,(0,i.jsx)(e.li,{children:\"Wait 30 to 60 seconds.\"}),`\n`,(0,i.jsxs)(e.li,{children:[\"Toggle \",(0,i.jsx)(e.strong,{children:\"Optimize Mac Storage\"}),\" back on.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[\"Open Activity Monitor and watch \",(0,i.jsx)(e.code,{children:\"bird\"}),\" for a minute. Network throughput should drop to near zero.\"]}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:\"In the best case, this resets the daemon's internal state and folder browsing stops triggering downloads for a few hours or days. In the worst case nothing changes and you need to move to Workaround 2.\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Caveat\"}),\": If macOS \",(0,i.jsx)(e.em,{children:\"did\"}),\" start downloading files between your two toggles, those files are now local. They will not be re-evicted automatically for some time (see the eviction policy issue above). You may want to follow up with Workaround 2 to manually free the space.\"]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"macOS Settings panel showing the Optimize Mac Storage toggle\",src:\"/images/blog/icloud-drive-auto-download-bug-macos-tahoe-26-4-fix-2026/optimize-storage-toggle.webp\",width:\"2848\",height:\"1504\"})}),`\n`,(0,i.jsxs)(e.h2,{id:\"workaround-2-manually-evict-files-with-brctl-evict\",children:[\"Workaround 2: Manually Evict Files with \",(0,i.jsx)(e.code,{children:\"brctl evict\"})]}),`\n`,(0,i.jsxs)(e.p,{children:[\"If files have already been auto-downloaded, you can push them back to the cloud manually using the \",(0,i.jsx)(e.code,{children:\"brctl\"}),\" command-line utility. \",(0,i.jsx)(e.code,{children:\"brctl\"}),\" is a real, shipped, Apple-provided tool \\u2014 \",(0,i.jsx)(e.code,{children:\"man brctl\"}),\" will confirm it on any Mac running Tahoe.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"The relevant command is \",(0,i.jsx)(e.code,{children:\"brctl evict\"}),', which \"evict[s] the local copy of the document at this path\" \\u2014 exactly what we want.']}),`\n`,(0,i.jsx)(e.h3,{id:\"single-file\",children:\"Single file\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"brctl\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" evict\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Mobile\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"\\\\ \"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\"Documents/com~apple~CloudDocs/Documents/old-invoice.pdf\"})]})})})}),`\n`,(0,i.jsxs)(e.p,{children:[\"The path inside \",(0,i.jsx)(e.code,{children:\"~/Library/Mobile Documents/com~apple~CloudDocs/\"}),' is where macOS actually stores iCloud Drive contents. The Finder shortcut \"iCloud Drive\" in the sidebar maps to that path. You can also drag a file from Finder into a Terminal window to paste its full path automatically.']}),`\n`,(0,i.jsx)(e.h3,{id:\"entire-folder-recursively\",children:\"Entire folder, recursively\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.code,{children:\"brctl evict\"}),\" does not have a built-in \",(0,i.jsx)(e.code,{children:\"-R\"}),\" recursion flag, so we combine it with \",(0,i.jsx)(e.code,{children:\"find\"}),\":\"]}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"find\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Mobile\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"\\\\ \"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\"Documents/com~apple~CloudDocs/Documents/Invoices\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -type\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" f\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -exec\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" brctl\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" evict\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" {}\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" \\\\;\"})]})})})}),`\n`,(0,i.jsxs)(e.p,{children:[\"This walks the entire \",(0,i.jsx)(e.code,{children:\"Invoices\"}),\" folder and evicts every file it finds. For a folder with hundreds of files this can take a minute or two \\u2014 that is normal.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"free-up-the-largest-files-first\",children:\"Free up the largest files first\"}),`\n`,(0,i.jsx)(e.p,{children:\"If you are in a hurry to recover disk space, target large files only:\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"find\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Mobile\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"\\\\ \"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\"Documents/com~apple~CloudDocs\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -type\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" f\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -size\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" +100M\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -exec\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" brctl\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" evict\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" {}\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" \\\\;\"})]})})})}),`\n`,(0,i.jsxs)(e.p,{children:[\"The \",(0,i.jsx)(e.code,{children:\"-size +100M\"}),\" filter restricts to files larger than 100 MB. Adjust to taste.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"check-status-before-and-after\",children:\"Check status before and after\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"brctl\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" status\"})]})})})}),`\n`,(0,i.jsx)(e.p,{children:\"This prints a snapshot of the CloudDocs daemon's state, including how many files are local versus cloud-only. Run it before and after your eviction pass to confirm the change.\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"Terminal window showing brctl evict commands and output\",src:\"/images/blog/icloud-drive-auto-download-bug-macos-tahoe-26-4-fix-2026/terminal-brctl-evict.webp\",width:\"2848\",height:\"1504\"})}),`\n`,(0,i.jsxs)(e.h3,{id:\"what-brctl-evict-does-not-do\",children:[\"What \",(0,i.jsx)(e.code,{children:\"brctl evict\"}),\" does \",(0,i.jsx)(e.em,{children:\"not\"}),\" do\"]}),`\n`,(0,i.jsx)(e.p,{children:\"It does not delete the file from iCloud. It only removes the local copy on this Mac. The file remains in the cloud and the Finder placeholder stays in place \\u2014 you can re-download it any time by double-clicking it (assuming the bug does not retrigger).\"}),`\n`,(0,i.jsx)(e.p,{children:\"It also does not work on files that have unsaved changes or are currently open in an application. Close the relevant apps first.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"a-sanity-check-before-you-run-wide-eviction\",children:\"A sanity check before you run wide eviction\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"Before you run \",(0,i.jsx)(e.code,{children:\"find ... -exec brctl evict {} \\\\;\"}),\" against a large tree, do a smaller dry run to confirm paths and behavior:\"]}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# List files that would be targeted, no eviction yet\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"find\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Mobile\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"\\\\ \"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\"Documents/com~apple~CloudDocs/Documents/Invoices\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -type\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" f\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -size\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" +100M\"})]}),`\n`,(0,i.jsx)(e.span,{className:\"line\"}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6A737D\",\"--shiki-dark\":\"#6A737D\"},children:\"# Then, once you have confirmed the list looks right, evict them\"})}),`\n`,(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"find\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Mobile\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"\\\\ \"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\"Documents/com~apple~CloudDocs/Documents/Invoices\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -type\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" f\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -size\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" +100M\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -exec\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" brctl\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" evict\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" {}\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" \\\\;\"})]})]})})}),`\n`,(0,i.jsxs)(e.p,{children:[\"If \",(0,i.jsx)(e.code,{children:\"bird\"}),\" is unable to evict a particular file (because it has uncommitted changes, is open elsewhere, or is part of an active iCloud sync operation) it will print an error and move on. Errors are non-fatal and do not stop the loop.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"You can also use \",(0,i.jsx)(e.code,{children:\"brctl dump com.apple.CloudDocs\"}),\" to print the full database state \\u2014 this is verbose and mostly useful as a forensic tool, but if eviction is failing for non-obvious reasons it may help you spot which files are stuck.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"A common pattern from frustrated users on the Apple thread is to wrap the eviction in a daily LaunchAgent \\u2014 essentially a scheduled job that runs \",(0,i.jsx)(e.code,{children:\"brctl evict\"}),\" against the entire iCloud Drive every night, on the assumption that the bug will refill the local cache during the day. We do not recommend this for most users because it is brittle and can interact badly with files you actually want offline. But if you understand \",(0,i.jsx)(e.code,{children:\"launchd\"}),\" and want to try it, the recipe is straightforward.\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"workaround-3-disable-optimize-mac-storage-entirely\",children:\"Workaround 3: Disable Optimize Mac Storage Entirely\"}),`\n`,(0,i.jsx)(e.p,{children:\"If your bandwidth situation is dire and you cannot afford even an accidental download, the nuclear option is to disable Optimize Mac Storage and accept that everything in iCloud Drive will live locally.\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Trade-off analysis:\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Pro\"}),\": No more surprise downloads. What is on disk is on disk. Network usage for iCloud Drive becomes purely the delta of files you create or modify.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Pro\"}),\": Predictable backups. Your nightly Time Machine and clones see only the files that actually changed.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Con\"}),\": You need free disk space equal to the full size of your iCloud Drive library. If you have 500 GB in iCloud and a 256 GB SSD, this is not an option for you.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Con\"}),\": The initial download after disabling Optimize Mac Storage is a one-time bandwidth hit equal to your entire library minus what is already local. For a 100 GB library, that is 100 GB of download.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Con\"}),\": You lose the convenience of opening any file in your library from any device \\u2014 you now need to be more deliberate about what lives in iCloud Drive at all.\"]}),`\n`]}),`\n`,(0,i.jsxs)(e.p,{children:[\"Many users in this situation use the moment as a forcing function to \",(0,i.jsx)(e.strong,{children:\"archive aggressively\"}),\". Old projects, old invoices, old screenshots \\u2014 move them to an external drive or an archive cloud (Backblaze B2, Wasabi, Dropbox cold storage) and remove them from iCloud Drive entirely. The \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-storage-management-optimization-guide-2025\",children:\"storage management guide\"}),\" walks through tools to identify what is taking up space.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"If you decide to go this route, expect the initial sync to take a long time \\u2014 often days for a large library \\u2014 and to keep your Mac plugged in and connected to power-friendly Wi-Fi during that period.\"}),`\n`,(0,i.jsx)(e.h2,{id:\"workaround-4-use-icloudcom-for-selective-access\",children:\"Workaround 4: Use iCloud.com for Selective Access\"}),`\n`,(0,i.jsx)(e.p,{children:\"For files you only need to access occasionally \\u2014 old tax documents, archived projects, reference PDFs \\u2014 there is no rule that says you have to access them through Finder at all. iCloud.com gives you a web-based file browser that downloads only what you actively click.\"}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"When this works well:\"})}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsx)(e.li,{children:\"You need one specific file from a folder, not the whole folder.\"}),`\n`,(0,i.jsx)(e.li,{children:\"You are on a metered connection and want to be deliberate about every byte.\"}),`\n`,(0,i.jsx)(e.li,{children:\"You are on a borrowed Mac or one with very little free disk space.\"}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.strong,{children:\"Steps:\"})}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[\"Visit \",(0,i.jsx)(e.a,{href:\"https://www.icloud.com\",children:\"iCloud.com\"}),\" in any modern browser and sign in.\"]}),`\n`,(0,i.jsx)(e.li,{children:\"Click iCloud Drive.\"}),`\n`,(0,i.jsx)(e.li,{children:\"Navigate to the file you want. Click it once to preview, or click the download icon to save it to your local Downloads folder (not your iCloud Drive folder \\u2014 important to keep it out of the sync loop).\"}),`\n`]}),`\n`,(0,i.jsxs)(e.p,{children:[\"This bypasses \",(0,i.jsx)(e.code,{children:\"bird\"}),\" and Finder entirely. The download happens via standard HTTPS to your browser, and the file does not become part of your iCloud Drive cache on this Mac.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"The downside is obvious \\u2014 for daily working files, swapping into a browser tab is friction you do not want. But as a release valve for occasional access while the bug persists, it is genuinely useful.\"}),`\n`,(0,i.jsx)(e.h2,{id:\"workaround-5-third-party-cloud-mounters-as-alternatives\",children:\"Workaround 5: Third-Party Cloud Mounters as Alternatives\"}),`\n`,(0,i.jsx)(e.p,{children:\"A handful of community members have switched to third-party tools that mount iCloud Drive (and other cloud services) as proper network volumes with strict on-demand semantics. The two most commonly mentioned:\"}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"CloudMounter\"}),\": Mounts iCloud Drive (and Dropbox, Google Drive, OneDrive) as a virtual disk. Only files you explicitly open are fetched. There is no Finder thumbnail prefetch because the mount uses a different protocol.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Mountain Duck\"}),\": Similar concept, with stronger emphasis on developer/SFTP workflows but with iCloud Drive support.\"]}),`\n`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Important caveats\"}),\": Neither tool has the same level of system integration as Apple's native iCloud Drive. Photos library sync, app sandbox container sync, and \",(0,i.jsx)(e.code,{children:\"~/Desktop\"}),\" and \",(0,i.jsx)(e.code,{children:\"~/Documents\"}),\" redirection do not work through these tools \\u2014 those still go through the native Apple stack. They are useful for a \",(0,i.jsx)(e.em,{children:\"specific\"}),\" archive or document folder you want strict control over, not as a wholesale replacement.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"We have not personally tested these against the 26.4 bug, so treat reports as anecdotal until you confirm on your own setup. If you do experiment, do it on a non-critical folder first.\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"For more on power-user iCloud workflows in general, see \",(0,i.jsx)(e.a,{href:\"/blog/icloud-drive-advanced-workflows-best-practices-2025\",children:\"iCloud Drive advanced workflows\"}),\".\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"bandwidth-and-storage-impact-rough-math\",children:\"Bandwidth and Storage Impact: Rough Math\"}),`\n`,(0,i.jsx)(e.p,{children:\"It helps to put numbers on the cost so you can prioritize.\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Bandwidth scenario.\"}),\" Assume a 100 GB iCloud Drive library where 70 GB was previously stored as cloud placeholders (Optimize Mac Storage was working as designed). If the bug triggers a wholesale rehydration over the course of a week of normal Finder browsing, you redownload up to 70 GB. On a 50 Mbps connection that is roughly three to four hours of saturated download \\u2014 or one month of a typical 100 GB cellular plan, gone in a week.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Storage scenario.\"}),\" Same 100 GB library, same 70 GB previously remote. After the bug runs its course you have 100 GB on disk. On a 256 GB SSD with the OS, apps, and other documents already taking 120 GB, you go from 66 GB free to nothing \\u2014 and macOS will start refusing to save new files, evicting caches randomly, and warning about low disk space.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Multi-Mac scenario.\"}),\" This is the one that hurts the most. If you have two Macs \\u2014 say a desktop and a laptop \\u2014 both running 26.4 with Optimize Mac Storage on, the bug triggers on each independently. Browsing your library on the laptop hydrates files there; browsing on the desktop hydrates the same files there too. That is 2\\xD7 the bandwidth cost. If your iCloud library lives on a NAS-backed Time Machine, you are also paying the storage cost on the backup target.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"These are rough numbers, but the order of magnitude matches what people are reporting in the threads.\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"A worked example.\"}),\" Consider a freelance designer with a 250 GB iCloud Drive that holds completed client projects going back several years. Under normal Optimize Mac Storage behavior, only about 40 GB lived locally on her 512 GB MacBook Pro at any given time \\u2014 recent projects, current invoices, a handful of references. After upgrading to 26.4 she opened her \",(0,i.jsx)(e.code,{children:\"Clients/2023/\"}),\" folder one evening to find a screenshot for a new pitch deck. Within 20 minutes her free disk space dropped from 180 GB to 60 GB. By morning, after Spotlight finished re-indexing the newly-downloaded files, she was at 28 GB free, with macOS warning her that startup disk was almost full. She had to spend an hour running \",(0,i.jsx)(e.code,{children:\"brctl evict\"}),\" against years of archived projects she did not need locally just to recover working space. None of those files had been touched intentionally. None of that bandwidth had been planned for.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"This is the lived experience of the bug for users with larger libraries and meaningful work to do. The numbers are not theoretical.\"}),`\n`,(0,i.jsx)(e.h2,{id:\"storage-strategy-going-forward\",children:\"Storage Strategy Going Forward\"}),`\n`,(0,i.jsx)(e.p,{children:'Even after Apple fixes this specific regression, the episode is a reminder that \"Optimize Mac Storage\" is not a magic spell \\u2014 it is a heuristic that can fail. Building some defense in depth into your storage strategy is worth it.'}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Be deliberate about what lives in iCloud Drive.\"}),\" If a folder is truly archival \\u2014 you reference it once a year \\u2014 it does not belong in iCloud Drive at all. Move it to an external SSD or an object-storage service. iCloud Drive should be reserved for files you actively work with across devices.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Use Photos library and iCloud Photos separately.\"}),\" Photos has its own optimization model that is more robust than iCloud Drive's. If your photo library is the bulk of your iCloud usage, the iCloud Drive bug does not directly affect it.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsxs)(e.strong,{children:[\"Monitor \",(0,i.jsx)(e.code,{children:\"bird\"}),\" periodically.\"]}),\" Add a quick check to your routine \\u2014 once a week, run \",(0,i.jsx)(e.code,{children:\"brctl status\"}),\" and \",(0,i.jsx)(e.code,{children:\"du -sh ~/Library/Mobile\\\\ Documents/com~apple~CloudDocs\"}),\" to see what is local. If the local size is creeping up unexpectedly, you can intervene early.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Set up disk-space alerts.\"}),\" macOS does warn about low disk space but only when it is critical. A more proactive monitor (DaisyDisk's free space widget, OmniDiskSweeper, or even a small shell script with \",(0,i.jsx)(e.code,{children:\"osascript\"}),\" notifications) can catch problems while you still have time to react.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"For a deeper treatment of these patterns, see our \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-storage-management-optimization-guide-2025\",children:\"storage management optimization guide\"}),\".\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"when-will-apple-fix-this\",children:\"When Will Apple Fix This?\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"The next macOS release in the Tahoe cycle is 26.5. As of early May 2026, beta 4 is in the hands of developers and public testers. Multiple users on the Apple Discussions thread report that the auto-download behavior is \",(0,i.jsx)(e.strong,{children:\"less severe\"}),\" in beta 4 \\u2014 folder browsing no longer triggers wholesale hydration in their tests. However, eviction still appears slower than pre-26.4 baseline, suggesting Apple has addressed the most acute symptom but not necessarily restored the original behavior.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"Based on Apple's typical release cadence, 26.5 general availability is expected in \",(0,i.jsx)(e.strong,{children:\"late May 2026\"}),\", possibly the week of May 18 or May 25. Apple has not formally confirmed the date, and historically dot-releases can slip into early June if late-stage regressions show up in beta.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"We have a separate breakdown of \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-26-5-beta-1-complete-guide-2026\",children:\"what is in 26.5 beta 1\"}),\" that we will update as betas progress. We will also update \",(0,i.jsx)(e.em,{children:\"this\"}),\" article when 26.5 GA ships and we can confirm whether the iCloud Drive behavior is back to pre-26.4 levels.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"In the meantime: \",(0,i.jsx)(e.strong,{children:\"do not assume the fix is in 26.5 GA\"}),\". Test it on your own setup before re-enabling Optimize Mac Storage if you have disabled it. Apple's release notes for dot-releases are notoriously sparse and a fix may or may not be called out explicitly.\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"best-practices-while-the-bug-is-live\",children:\"Best Practices While the Bug Is Live\"}),`\n`,(0,i.jsx)(e.p,{children:\"To summarize the recommended posture for the next month or so:\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Know your library size\"}),\". Run \",(0,i.jsx)(e.code,{children:\"du -sh ~/Library/Mobile\\\\ Documents/com~apple~CloudDocs\"}),\" to see how much is local right now, and check System Settings \\u2192 Apple Account \\u2192 iCloud to see your total iCloud Drive usage.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Decide your tolerance.\"}),\" If you have plenty of disk and unmetered bandwidth, you can afford to leave Optimize Mac Storage on and clean up periodically with \",(0,i.jsx)(e.code,{children:\"brctl evict\"}),\". If either is constrained, disable Optimize Mac Storage and live with full local copies \\u2014 or move the most archival content out of iCloud Drive.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Avoid casual browsing of large iCloud folders\"}),\". Until 26.5 ships and is confirmed, treat Finder navigation into archive folders as a deliberate act, not idle clicking.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Watch your backups\"}),\". A bug-driven hydration storm can multiply backup sizes by 10\\xD7 or more for a single run. If you have backup quotas, watch them.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"File a Feedback Assistant report\"}),\". Even if Apple is aware of the bug, additional reports with reproducible cases and \",(0,i.jsx)(e.code,{children:\"sysdiagnose\"}),\" attachments add weight. Use Feedback Assistant on macOS, file under iCloud \\u2192 iCloud Drive, and describe your symptoms specifically.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Update your reference docs\"}),\". The \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-26-4-26-4-1-complete-update-guide-2026\",children:\"26.4 / 26.4.1 update guide\"}),\" and the \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-icloud-drive-complete-guide-2025\",children:\"iCloud Drive complete guide\"}),\" are worth bookmarking \\u2014 we update both as the situation evolves.\"]}),`\n`]}),`\n`,(0,i.jsx)(e.h2,{id:\"faq\",children:\"FAQ\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Q1. Is this bug confirmed by Apple?\"}),`\nNo. As of early May 2026, Apple has not made any public statement about the iCloud Drive auto-download behavior in 26.4. Acknowledgment exists only in community threads such as Apple Discussions thread 256273434.`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Q2. Does this affect iOS or iPadOS?\"}),`\nThe Finder-specific trigger does not exist on iOS or iPadOS because they use a different file browser. However, some iPadOS users report similar increased downloads in the Files app after recent updates. The cause may or may not be related \\u2014 it is a separate investigation.`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Q3. If I disable Optimize Mac Storage, will my files in the cloud be deleted?\"}),`\nNo. Disabling Optimize Mac Storage only changes the local-cache policy. Your files remain in iCloud. The change just means more of them live on your Mac at the same time as in the cloud.`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsxs)(e.strong,{children:[\"Q4. Does \",(0,i.jsx)(e.code,{children:\"brctl evict\"}),\" work on Photos library files?\"]}),`\nThe Photos library has its own optimization model and does not use the same `,(0,i.jsx)(e.code,{children:\"bird\"}),\" placeholders as iCloud Drive. \",(0,i.jsx)(e.code,{children:\"brctl evict\"}),\" is not the right tool for Photos. For Photos space management, use System Settings \\u2192 Apple Account \\u2192 iCloud \\u2192 Photos and the \",(0,i.jsx)(e.strong,{children:\"Optimize Mac Storage\"}),\" toggle there, which is a separate setting from the iCloud Drive one.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsxs)(e.strong,{children:[\"Q5. Can I script \",(0,i.jsx)(e.code,{children:\"brctl evict\"}),\" to run automatically?\"]}),`\nYes, via a `,(0,i.jsx)(e.code,{children:\"launchd\"}),\" LaunchAgent or even a simple cron entry. We do not recommend it as a default because it can evict files you actually want offline. If you do, scope it tightly \\u2014 for example only files larger than 100 MB and not modified in the last 30 days.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Q6. Does the bug happen with third-party cloud services?\"}),`\nNo. Dropbox, Google Drive, and OneDrive use their own daemons and have not been reported to exhibit similar behavior. The bug is specific to Apple's iCloud Drive stack on macOS 26.4.`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Q7. Will rolling back to 26.3 fix it?\"}),`\nTechnically yes, but Apple does not officially support rolling back point releases. You would need to reinstall from a USB installer of an earlier macOS, which means erasing and restoring from backup. For most users this is a worse option than living with the bug for a few weeks.`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Q8. What about Safe Mode \\u2014 does the bug occur there?\"}),`\nSafe Mode disables Spotlight indexing and many background services. Some users report the bug is less severe in Safe Mode, which supports the theory that Spotlight indexing or thumbnail prefetch is involved. Safe Mode is not a usable long-term workaround but it is a useful diagnostic.`]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Q9. I bought extra iCloud storage to deal with this \\u2014 is that the right move?\"}),`\nNo. Extra iCloud storage gives you more `,(0,i.jsx)(e.em,{children:\"cloud\"}),\" space. The bug is about your \",(0,i.jsx)(e.em,{children:\"local\"}),\" disk and bandwidth. Buying more iCloud storage does not help. If anything it makes the worst case worse because there is more potential data to redownload.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Q10. Will the eventual 26.5 fix re-evict already-downloaded files?\"}),`\nProbably not automatically. The fix is most likely to address the trigger (preventing future over-aggressive downloads) rather than retroactively cleaning up the cache. After 26.5 ships, you will likely still want to do a one-time `,(0,i.jsx)(e.code,{children:\"brctl evict\"}),\" pass on folders you do not need offline.\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"conclusion\",children:\"Conclusion\"}),`\n`,(0,i.jsx)(e.p,{children:\"The iCloud Drive auto-download bug in macOS Tahoe 26.4 is a textbook example of how a small regression in a low-level service \\u2014 file coordination, in this case \\u2014 can cascade into real costs for end users. The fix is in Apple's hands and appears to be partially in place in the 26.5 beta. Until then, the four workarounds outlined here can substantially limit the damage:\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsx)(e.li,{children:\"Toggle Optimize Mac Storage off and back on as a quick reset.\"}),`\n`,(0,i.jsxs)(e.li,{children:[\"Use \",(0,i.jsx)(e.code,{children:\"brctl evict\"}),\" to manually free space after files have auto-hydrated.\"]}),`\n`,(0,i.jsx)(e.li,{children:\"Disable Optimize Mac Storage entirely if your bandwidth situation requires it.\"}),`\n`,(0,i.jsx)(e.li,{children:\"Use iCloud.com for selective access of archival files.\"}),`\n`]}),`\n`,(0,i.jsxs)(e.p,{children:[\"For ongoing context, our \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-icloud-drive-complete-guide-2025\",children:\"iCloud Drive complete guide\"}),\", \",(0,i.jsx)(e.a,{href:\"/blog/icloud-drive-advanced-workflows-best-practices-2025\",children:\"advanced iCloud workflows\"}),\", and \",(0,i.jsx)(e.a,{href:\"/blog/best-mac-backup-strategy-2026-time-machine-icloud-clone\",children:\"backup strategy guide\"}),\" cover the longer-term posture. The \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-26-4-26-4-1-complete-update-guide-2026\",children:\"26.4 update guide\"}),\" and \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-26-5-beta-1-complete-guide-2026\",children:\"26.5 beta 1 guide\"}),\" track the broader release picture. We will update this article when 26.5 ships and confirm whether the bug is fully resolved.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"If you have additional reproductions or details to share, the best place to add them remains \",(0,i.jsx)(e.a,{href:\"https://discussions.apple.com/thread/256273434\",children:\"Apple Discussions thread 256273434\"}),\" \\u2014 the more concrete reports there, the more pressure on Apple to ship a clean fix.\"]})]})}function c(t={}){let{wrapper:e}=t.components||{};return e?(0,i.jsx)(e,{...t,children:(0,i.jsx)(d,{...t})}):d(t)}return k(v);})();\n;return Component;","toc":[{"title":"Key Takeaways","url":"#key-takeaways","depth":2},{"title":"What Users Are Actually Seeing","url":"#what-users-are-actually-seeing","depth":2},{"title":"Why This Matters More Than It Sounds","url":"#why-this-matters-more-than-it-sounds","depth":2},{"title":"Confirming You Have the Bug","url":"#confirming-you-have-the-bug","depth":2},{"title":"Root Cause: What Probably Changed in 26.4","url":"#root-cause-what-probably-changed-in-264","depth":2},{"title":"Workaround 1: Toggle Optimize Mac Storage Off Then On","url":"#workaround-1-toggle-optimize-mac-storage-off-then-on","depth":2},{"title":"Workaround 2: Manually Evict Files with brctl evict","url":"#workaround-2-manually-evict-files-with-brctl-evict","depth":2},{"title":"Single file","url":"#single-file","depth":3},{"title":"Entire folder, recursively","url":"#entire-folder-recursively","depth":3},{"title":"Free up the largest files first","url":"#free-up-the-largest-files-first","depth":3},{"title":"Check status before and after","url":"#check-status-before-and-after","depth":3},{"title":"What brctl evict does not do","url":"#what-brctl-evict-does-not-do","depth":3},{"title":"A sanity check before you run wide eviction","url":"#a-sanity-check-before-you-run-wide-eviction","depth":3},{"title":"Workaround 3: Disable Optimize Mac Storage Entirely","url":"#workaround-3-disable-optimize-mac-storage-entirely","depth":2},{"title":"Workaround 4: Use iCloud.com for Selective Access","url":"#workaround-4-use-icloudcom-for-selective-access","depth":2},{"title":"Workaround 5: Third-Party Cloud Mounters as Alternatives","url":"#workaround-5-third-party-cloud-mounters-as-alternatives","depth":2},{"title":"Bandwidth and Storage Impact: Rough Math","url":"#bandwidth-and-storage-impact-rough-math","depth":2},{"title":"Storage Strategy Going Forward","url":"#storage-strategy-going-forward","depth":2},{"title":"When Will Apple Fix This?","url":"#when-will-apple-fix-this","depth":2},{"title":"Best Practices While the Bug Is Live","url":"#best-practices-while-the-bug-is-live","depth":2},{"title":"FAQ","url":"#faq","depth":2},{"title":"Conclusion","url":"#conclusion","depth":2}],"estimatedTime":26}