Install
Download the Reclaim disk image for Mac, open it through Privacy & Security the first time, and give it Full Disk Access. Plus updating, uninstalling and building from source.
Install from Terminal
The quickest way, and macOS opens Reclaim straight away with no warning. Paste this into Terminal:
curl -fsSL https://reclaim.mostofa.me/install.sh | shIt downloads the latest Reclaim.dmg, checks it against its published checksum, copies Reclaim into Applications and opens it. Run it again any time to update. You can read the script first.
curl are not marked, so there is nothing to allow.Or download the disk image
Get the app
Download Reclaim.dmg, the latest version, ready to run: there is nothing to build. The release page also has Reclaim.dmg.sha256 to check it, and the same app as Reclaim.zip.
Check the download (optional)
In Terminal, in the folder you downloaded to:
shasum -a 256 -c Reclaim.dmg.sha256It should print Reclaim.dmg: OK.
Move it to Applications
Double-click Reclaim.dmg and drag Reclaim onto the Applications folder in the window that opens. Then eject the disk image in Finder.
Open it the first time
If you used the disk image: Reclaim is not notarized by Apple, because notarization needs a paid developer membership, so macOS blocks it the first time with "Apple could not verify… is free of malware". You do this once per version.
The quickest fix is one Terminal command, run before you open the disk image, that removes the quarantine mark macOS put on the download:
xattr -d com.apple.quarantine ~/Downloads/Reclaim.dmgOr allow it in System Settings:
Try to open it
Double-click Reclaim.dmg (or Reclaim in Applications). macOS says it cannot verify it. Click Done, not Move to Trash.
Open Privacy & Security
Go to System Settings › Privacy & Security and scroll to the Security section.
Allow it
Next to the message about Reclaim, click Open Anyway and confirm with your password or Touch ID. If you allowed the disk image, macOS asks once more for the app itself the first time you open it from Applications: repeat these steps.
Give it Full Disk Access
Without it, macOS asks for permission the first time any app opens Desktop, Documents, Downloads, iCloud Drive or another app's data, and the app has to wait for your answer. To keep scans from stalling, Reclaim skips those folders until it has Full Disk Access, and the Overview says so, with a button to the right settings page.
Open the setting
Go to System Settings › Privacy & Security › Full Disk Access.
Add Reclaim
Click +, choose Reclaim in Applications, and make sure its switch is on.
Scan again
Quit and reopen Reclaim, then scan.
No app can grant this to itself, and Reclaim never asks again once it is on.
Updating
Download the new release and replace the old app in Applications. Because each build is signed separately, macOS may ask you to repeat Open Anyway, you may need to switch Full Disk Access off and on again, and the helper, if you use it, asks to be paired again.
Uninstalling
Remove the helper
If you installed it: open System in the sidebar and click Remove Helper….
Remove the app
Quit Reclaim and move it from Applications to the Trash.
Remove its settings and history (optional)
rm ~/Library/Preferences/io.github.kstmostofa.reclaim.plist
rm -r ~/Library/Application\ Support/ReclaimTidy up permissions
Remove it from Full Disk Access and, if you turned it on, from Login Items in System Settings.
Build from source
You need Xcode and XcodeGen.
brew install xcodegen
git clone https://github.com/kstmostofa/reclaim.git
cd reclaim
xcodegen generate
open Reclaim.xcodeprojThe engine's tests run with swift test in Packages/ReclaimCore. They only ever create and delete files in temporary folders.
Introduction
Reclaim is a free, open-source Mac app that finds build caches, dependencies, app caches and Docker leftovers, explains what is safe to delete, and frees the space in one click.
Scan and clean
How to scan your Mac with Reclaim, read the Overview, review suggestions by safety level, and delete caches, node_modules and other junk in one click.