Uninstall Mac apps with every file they leave behind, and see why each belongs. Free up space, fine-tune macOS, and set up Terminal.
Swift cache-cleanercleanerclideveloper-toolsdisk-cleanupdisk-spaceduplicate-finderhomebrewliquid-glassmac-cleanermacosmacos-appmacos-golden-gatemacos-tahoemacos-tweaksswiftswiftuiterminal-themesuninstalluninstaller
Name the folders Put Back takes back among what Peel deletes outright
Țugui Dragoșbcecc685c712
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.mdindex ad4f14f2..674fd1ec 100644--- a/ARCHITECTURE.md+++ b/ARCHITECTURE.md@@ -186,18 +186,19 @@ A handful of ideas carry most of the weight. Each is enforced in one place and t- **The Trash, never deletion.** Nothing in Peel deletes anything of the user's. What it deletes outright holdsnothing of theirs: the empty placeholder `TrashMover` makes to hold a name on a disk that cannot rename withoutreplacing (exFAT), when the move it was made for fails; the folder `PreferenceBackup` makes for a reset's saved- settings, when saving fails while it is still empty; and the empty file cfprefsd writes back where a moved- settings file was when `PreferenceCleanup` forgets a domain it still holds, which would keep History from putting- that file back. Peel's list of refusals goes to the Trash when `peel history --refused --clear` asks. Four- actions can't be undone by History, and each says so where it is confirmed: Homebrew's own uninstall and- cleanups, resetting an app's privacy permissions, and Force Quit for an app that is still open 10 seconds after- Peel asked it to quit (`QuitBeforeRemoving`). Moving Mullvad VPN, Citrix Workspace, or TeamViewer starts that- app's own uninstaller, which deletes what History can't bring back, and Peel says so before it moves them- (`UninstallsItself`). Forgetting a preference domain happens only once its file is in the Trash, so putting the- file back undoes it, or, when saved settings are put back, once the settings in use are saved as a copy of their- own (`PreferenceBackup`). Every `brew` call runs without Homebrew's automatic cleanup- (`HOMEBREW_NO_INSTALL_CLEANUP`), so an upgrade never deletes on its own; when a `brew.env` file of the user's- turns that back on (`Homebrew.overrides()`, from `brew config`), the Homebrew page says so and leaves upgrades to+ settings, when saving fails while it is still empty; the folders Put Back makes on the way back+ (`DirectoryHandle.child(_:makingIfMissing:)`), when the item then stays in the Trash and each is still the empty+ folder it made; and the empty file cfprefsd writes back where a moved settings file was when `PreferenceCleanup`+ forgets a domain it still holds, which would keep History from putting that file back. Peel's list of refusals goes+ to the Trash when `peel history --refused --clear` asks. Four actions can't be undone by History, and each says so+ where it is confirmed: Homebrew's own uninstall and cleanups, resetting an app's privacy permissions, and Force Quit+ for an app that is still open 10 seconds after Peel asked it to quit (`QuitBeforeRemoving`). Moving Mullvad VPN,+ Citrix Workspace, or TeamViewer starts that app's own uninstaller, which deletes what History can't bring back, and+ Peel says so before it moves them (`UninstallsItself`). Forgetting a preference domain happens only once its file is+ in the Trash, so putting the file back undoes it, or, when saved settings are put back, once the settings in use are+ saved as a copy of their own (`PreferenceBackup`). Every `brew` call runs without Homebrew's automatic cleanup+ (`HOMEBREW_NO_INSTALL_CLEANUP`), so an upgrade never deletes on its own; when a `brew.env` file of the user's turns+ that back on (`Homebrew.overrides()`, from `brew config`), the Homebrew page says so and leaves upgrades toTerminal.- **One guard.** `RemovalGuard` decides, for the app and the `peel` tool alike, whether an item may move. Itslist of what nothing can bring back lives in `ProtectedData`, in PeelPrivileged, so the helper applies thediff --git a/SAFETY.md b/SAFETY.mdindex 6fc3f653..3288c5af 100644--- a/SAFETY.md+++ b/SAFETY.md@@ -185,9 +185,10 @@ themselves; on one that cannot, such as exFAT, Peel first takes the name with anfree name allows, and the move then replaces the placeholder.What Peel deletes outright holds nothing of yours: such a placeholder, when the move it was made for fails; the folder-it makes to save an app's settings before a reset, when saving fails before anything is written in it; and the empty-settings file macOS writes back when Peel forgets a preference domain, as described below. Its list of refusals goes-to the Trash when `peel history --refused --clear` is asked to forget it, after a question.+it makes to save an app's settings before a reset, when saving fails before anything is written in it; the folders it+makes again on the way back for a Put Back, when the item then stays in the Trash and each is still the empty folder it+made; and the empty settings file macOS writes back when Peel forgets a preference domain, as described below. Its list+of refusals goes to the Trash when `peel history --refused --clear` is asked to forget it, after a question.Four things Peel starts can't be undone by History, and Peel says so before you confirm each of them: