CloudeRm shows how much space iCloud Drive takes on your Mac, folder by folder, and lets you remove the local copies you don't need. The files stay in iCloud and download again the moment you open them, exactly like Finder's Remove Download, but for whole folders at once and with a clear picture of where the space went.
With Optimize Mac Storage on, macOS decides on its own what stays downloaded. With it off, everything stays on the Mac. Neither tells you that Video Edits quietly holds 22 GB on disk while Photos Archive is already cloud-only.
CloudeRm answers three questions at a glance:
- What is in iCloud? The total size of every folder, including files that live only in the cloud.
- What is on this Mac? How much of each folder is downloaded right now.
- What can I free up? One click per folder, with progress, and nothing is ever deleted from iCloud.
Every folder with its size in iCloud, its size on this Mac, and where its files are.
Open a folder, free it up, and keep queueing more while the progress bar runs.
Monochrome in both themes. It follows macOS, or stays light or dark if you pick one.
Screenshots are rendered from the real app with made-up sample data. GitHub shows the light or dark ones to match your theme.
| Status | Meaning |
|---|---|
| On Mac | Every file in the folder is downloaded. |
| Partial | Some files are downloaded, the rest are only in iCloud. |
| In iCloud | Nothing is downloaded; the folder takes no space on this Mac. |
The three cards on top add it up: everything in iCloud, what is on this Mac and can be freed, and what is already only in iCloud.
- Fast scan straight from disk. Reads file attributes in bulk with
getattrlistbulkand the APFS dataless flag instead of asking the iCloud daemon about every file, which is far faster on large drives. Nothing gets downloaded while scanning. - Folder breakdown. Size in iCloud, size on this Mac, file and folder counts, last modification, and a download percentage for every folder, including folders that are entirely cloud-only.
- Filter, sort, search. The sidebar shows only folders that are On Mac, Only in iCloud, Partial or Large Folders; sort by size, name, date or file count; search by folder name or path.
- Free up space safely. Remove local copies of a whole folder or of single files. Removals run in a queue with a progress bar and a running total of freed space, and you can add more folders while it works.
- Understands documents. Packages such as
.pages,.keyor.logicxcount as single items, just as iCloud treats them. - Spots unsynced files. Reports local files inside iCloud Drive that iCloud doesn't sync (e.g.
.tmp,Thumbs.db); they can't be freed this way. - Instant start. The last scan is cached and shown immediately on launch; Scan Now refreshes it.
- Light and dark. A monochrome interface that follows the system appearance, or stays light or dark if you pick one with the button next to Storage or in Settings (⌘,).
- Full Scan fallback. A slower scan through
FileManagerthat relies only on iCloud's own resource values, for folders the fast scan can't read. The app offers it when the fast scan fails; you can also run it from File → Full Scan (⇧⌘R).
CloudeRm never deletes files. Freeing up space calls FileManager.evictUbiquitousItem(at:), the same system API behind Finder's Remove Download. Before each removal it re-checks that the item:
- is an iCloud item, not a regular local file;
- is not currently downloading;
- still has a local copy.
Anything that fails a check is skipped and reported. The app is sandboxed, can access only the folder you choose, makes no network requests, and collects no data.
Note
Removed files download again when you open them, and macOS may re-download files on its own if an app needs them.
- macOS 26.5 or later
- iCloud Drive turned on
- Xcode 26 or later to build from source
There are no prebuilt releases yet; build it from source:
git clone https://github.com/olchu/CloudRm.git
cd CloudRm
open CloudeRm.xcodeprojSelect your team under Signing & Capabilities, then press ⌘R.
scripts/build_dmg.shThis builds a Release archive and packs it into build/CloudeRm-<version>.dmg. Signed with an Apple Development certificate, the DMG runs only on your own Macs. To notarize it for any Mac, see the comments at the top of scripts/build_dmg.sh; this needs a Developer ID Application certificate.
- Click Analyze iCloud Drive, or pick another folder with Choose Folder… in the sidebar.
- Browse the folders, largest first. Use the sidebar to show only On Mac, Partial, Only in iCloud or Large Folders, and the switch above the list to sort by name, date or file count.
- Open a folder and click Free Up Space, or use the upload button next to a single file.
- Watch the progress bar. Freed files leave the list, and their size moves to Only in iCloud.
If the fast scan can't read a folder, the app offers a slower Full Scan; it is also in File → Full Scan (⇧⌘R).
| File | Role |
|---|---|
CloudFileDiskScanner.swift |
Fast scanner. Walks directories on a pool of worker threads with getattrlistbulk, turns off dataless-file materialization so nothing downloads, and sums per-folder totals. |
CloudFileScanner.swift |
Full Scan fallback using FileManager.enumerator and iCloud resource values. |
CloudFileEvictor.swift |
Validates each item and calls evictUbiquitousItem(at:). |
CloudFilesViewModel.swift |
Scan and eviction state, the eviction queue, and the folder summaries computed off the main thread. |
CloudFileCache.swift |
Remembers the last folder (security-scoped bookmark) and caches the last scan. |
FileAccess.swift |
Folder picker and security-scoped access. |
ContentView.swift |
The SwiftUI interface (not MIT-licensed, see License). |
scripts/readme-images/render.shThis compiles the app's views and asset catalog together with RenderReadmeImages.swift and renders into docs/images, from fixed sample data:
hero.pngandsocial-preview.jpg, the banners;screenshot-overview-*.pngandscreenshot-folder-*.png, each in alightand adarkversion;screenshot-themes.png, the light and dark split.
Issues and pull requests are welcome. Please keep changes focused, and check that the project builds with:
xcodebuild -project CloudeRm.xcodeproj -scheme CloudeRm -configuration Debug CODE_SIGNING_ALLOWED=NO buildThe source code is released under the MIT License, with these exceptions:
CloudeRm/ContentView.swift, the app's user interface;- the CloudeRm name and app icon;
- the Olchu Studio logo;
- the app's visual design;
- the images in
docs/images.
These are © 2026 olchu, all rights reserved. Forks are welcome to use the scanning and eviction code, but need their own interface, name and icon; see NOTICE.md.

