Uninstall Mac apps with every file they leave behind, and see why each belongs. Free up space, fine-tune macOS, and set up Terminal.
Using Peel
What each tool in Peel does, what Peel asks for and why, and how to remove it. README.md says what Peel is and how to get it, SAFETY.md what it protects, PRIVACY.md what it sends, and TERMINAL.md every Terminal theme and setting.
Uninstall apps completely
- Every leftover, with a reason. Peel searches the places apps keep files: Application Support, caches, containers and group containers, preferences, saved state, logs, launch agents and daemons, plug-in folders, and more. Each file comes with the reason it matched, such as the app's bundle identifier, its signing team, or a Homebrew cask that names it.
- What Peel is sure of, or nearly, is selected. Files Peel matched by the app's identifier or its name, and its installer's receipt when nothing else on it is left outside the app, are selected for you, and so is the folder Homebrew keeps for an app it installed, so that Homebrew stops listing the app once it is gone. A match on the name alone is only a guess in your home folder, at the top of a Library, or inside another app's folder or one of Apple's, so it waits under Review Before Removing. So does a folder named like the app while another installed app's name holds that name, as Epic Games Launcher holds Epic: the folder may be that app's.
- What may exist nowhere else is left to you. A folder holding a crypto wallet, a signing key, a password database, or a repository is shown with its reason and not selected, and so is a place where an app keeps what may exist only on this Mac, such as local mail, message history, sign-in codes, a browser's or a remote access app's saved passwords, VPN connections, a torrent client's list of torrents, a game's saves, virtual machines and Windows bottles, a database, a database client's saved connections, a debugging proxy's rules, a video editor's projects, an AI app's conversations, a code editor's notes, unsaved files, and local history, an app's own backups, or the sign-in a tool saved when you logged in. Uninstalling Xcode lists the simulators it made the same way, and uninstalling Genymotion or Rancher Desktop lists its virtual machines.
- Shared or guessed, never selected. A file another installed app also uses is shown but never selected, and a
folder holding another installed app's own data, such as Xcode's in
~/Library/Developer, can't be selected at all, and neither can anything that syncs to your other devices, an app's container holding your documents, or a folder around a photo or music library. What Peel only guesses at, from the start of a name or an identifier the app's maker or signing team also uses, waits under Review Before Removing, with what is shared and what Peel held back. What is named for another app of the same maker that macOS knows, such as a build Xcode keeps, is that app's and isn't listed, and an identifier a tool gives apps whose makers set none, such as Electron'scom.electron.ones, ties no two apps to one maker. When no other app of its maker is installed, what the maker's own folder holds, such asApplication Support/Microsoftfor the last of Microsoft's apps, or/Users/Shared/Epic Gamesfor Epic's launcher, waits there too. - What only an administrator can move stays where it is when Peel's helper isn't allowed to move it from there. Once the app is gone, Peel says how many items stayed, and Orphaned Files lists them under Needs an Administrator, with how to remove them in Finder.
- Some apps go another way. An app that installed a system extension, such as a VPN or a virtual camera, is listed with its files and nothing selected: only Finder's move to the Trash asks macOS to remove the extension, so its page says to move it there. A security or management agent, a VPN, or another app whose maker documents an uninstaller of its own, such as GlobalProtect, Microsoft Defender, ExpressVPN, or Laravel Herd, is left to that uninstaller, and its page says how. An app that runs its own uninstaller once it leaves the Applications folder, such as Mullvad VPN or Citrix Workspace, is moved only after Peel tells you what that uninstaller will do. Peel itself goes only with Remove Peel, in Settings > General.
- Open apps quit first. Peel asks an app that is open to quit before anything of it moves, and looks again at what it left once it has. If the app is still open after 10 seconds, Peel offers Force Quit, which loses what the app hasn't saved.
- The Select menu has Select Recommended, Select All, and Deselect All. Select All selects everything you can select, what Peel holds back included, and asks first when that takes anything Peel doesn't recommend. In Duplicates it has no Select All, since one copy of every group always stays.
- Several ways in. Choose an app in the list, drop one on Peel's Dock icon, select several apps at once, or
Control-click an app in Finder and choose Uninstall with Peel, once the Finder extension is on in System
Settings; an app in macOS's own
/Systemfolder doesn't offer it, since nothing moves from there. With Watch the Trash on, Peel notices when you drag an app to the Trash yourself and offers to clear what it left behind, while Peel is open or in the menu bar, and once it has Full Disk Access. An old copy thrown away while another copy of the app is still installed brings no such offer, since nothing was left behind. Apps you keep outside the Applications folders, such as on another disk, join the list once you add their folder in Settings > General > App Folders, and so do apps kept deeper in an Applications folder than the three levels Peel looks through, such as the editors Unity Hub installs in/Applications/Unity/Hub/Editor. - Reset instead of remove. Reset, on an app's page, clears its settings without uninstalling it, and never selects your own work. Peel saves a copy of the settings first: put them back from the Reset sheet right away, or later from Settings > General > Saved Settings, which keeps each copy until you move it to the Trash, since a copy can hold a license key or an account.
- Privacy permissions too, if you want. Peel can also reset the permissions macOS gave the app, such as access to the camera and the microphone. History can't undo this: the app asks again for each one.
- Its Dock icon too. Peel takes the app's icon out of the Dock, where it would stay as a question mark, unless you deselect it, and History puts it back where it was when you put the app back. An app you had already moved to the Trash loses its icon once the files it left behind move, and History doesn't put that icon back.
- When macOS needs more. After a removal, Peel says when macOS keeps using what moved: an audio driver until you restart your Mac, and an app's login items, which macOS starts from the Trash until you empty it.
- A root certificate stays trusted. Before an app such as Charles or Proxyman goes, or a tool such as mkcert, Caddy, or mitmproxy is uninstalled on the Homebrew page, Peel says that the root certificate it added stays trusted on this Mac, and how its maker, or Keychain Access, stops trusting it. Peel never changes a keychain.
- Lines that still point to what moved. After a removal, Peel reads the files your shell runs when it starts
(
.zshrcand the others zsh, bash, and fish read) and names each line that still points to what moved, such as aPATHentry or an alias into the app, so a new shell stops printing an error once you edit it. Peel changes none of these files. - What it opens. An app's page lists the kinds of files and links it opens by default, and what would open them once it's gone. Peel never changes that itself.
- Updates for your apps. Peel checks your apps for new versions, through the update feed each app names, the App
Store for apps bought there, iPhone and iPad apps on the Mac included, or Homebrew, for apps it installed and, through
the catalog of casks it keeps on this Mac, for apps whose bundle a cask names, in the order Prefer updates from in
Settings > General sets, and shows what is new in the version that waits, as the app's own notes say it, even with no
connection. Apps that came with macOS are left to Software Update, and apps from Setapp to Setapp, which keep them
current. For an app Homebrew didn't install, never one from the App Store, its catalog answers last, after the app's
own feed, and counts an update only when its version is written with as many numbers as the app's and they are higher,
and since Homebrew can't upgrade that copy, the app's page says to update it from inside the app or from its homepage.
What Homebrew says counts for a day after it last checked for new versions, the time Homebrew itself waits before it
checks again. Past that, an app only Homebrew can answer for reads Can't check for updates until Homebrew checks
again, with Update Homebrew on the Homebrew page or
brew updatein Terminal, and Peel reads Homebrew again once it has. Homebrew can't say at all for a cask that installs whatever is newest each time, nor, when its settings leave apps that update themselves to their own updates, for such an app it installed, so those read Can't check for updates too, unless the app names a feed. Peel asks about each app again on a schedule of its own, less often while nothing changes, and when it opens, about every app it last asked a day ago or more. Rescan in Applications asks about every app again at once. Skip This Version and Never Check This App keep it quiet about the ones you want left alone, and Settings > General lists them under Muted Updates, where Check Again brings their updates back. Turning off Check for app updates there stops the checks, and after a week an app's Up to date, which Peel then no longer renews, says the day it was found.
Free up disk space
Space shows what fills your disk, area by area, and what each area is.
- Orphaned Files: files left behind by apps you already removed. Each group is tied to its app by the app's
identifier, by a folder a code editor or a JetBrains IDE named for its data, by the name of an app Peel saw
installed and then saw go, with or without its spaces and dashes and also at the top of a Library, by the name the
app's own identifier gives it, such as
VirtualBuddyforcodes.rambo.VirtualBuddy, when that identifier stays in what the app left, or, for the copy macOS keeps of a system extension, by the app macOS's own record names. What only a name ties to an app is shown and never selected. An app on another disk keeps its files out of the list while that disk isn't connected, once Orphaned Files has looked with the disk connected. It also lists the files browsers keep to start a helper program that is gone. In your account's temporary folder, where every program writes files named as it likes, it lists only what came with an app it saw go, as it does for plug-ins. Nothing is selected for you. A system extension's copy can't be selected, since only macOS removes it, and its row says how. Peel doesn't list what only a guess could tie to an app, so look for it yourself: a folder named only for a maker, such asGooglein Application Support, a data folder only the app's documentation names, such as Tor Browser'sTorBrowser-Data, a folder named like a gone app while another installed app's name holds that name, such as one called Epic beside Epic Games Launcher, and a hidden folder in your home named like an app, since one such as~/.localis shared by many command-line tools. What only an administrator can move, from a place Peel's helper isn't allowed to move it from, is listed apart under Needs an Administrator, with how to remove it in Finder, and so is what an uninstall left there, which nothing else would tie to the app once it is gone. A kernel extension there says to restart once it is in the Trash and, on a Mac with Apple silicon, how to set the startup disk's security back to Full Security if you lowered it to install one. - Developer: caches of developer tools, editors, browsers, and AI models. Nothing is selected for you, and Select Recommended passes by what you may want again; toolchains or anything holding an account are never listed.
- Build Artifacts: what builds left in your projects, like
node_modules,DerivedData, ortarget, each only when its tool's own file proves it. Nothing is selected for you, and Select Recommended passes by a project changed in the last 7 days. - Duplicates: files and whole folders with identical contents, compared with SHA-256. Unless you choose folders,
it looks in Desktop, Documents, Downloads, Pictures, Movies, and Music. Files under 100 KB, and folders holding
less, are left out unless you choose a smaller size, in the app and in
peel duplicatesalike. A copy with Finder tags, a Finder comment, or a resource fork the others lack is marked Stays and never moved, since moving it would lose them, and the others can all go. A group where each copy has something the others lack isn't listed. After a scan you start, Peel selects every copy in each group but the one it suggests keeping: one on the disk your home folder is on, then one outside/Users/Shared, then one outside Downloads, then one whose name doesn't end like a copy's, such asphoto copy.jpgorphoto (1).jpg, then the oldest. A copy in/Users/Sharedisn't selected for you, since every account may use it. Look before you move them: one copy is always kept. A copy in a folder that syncs to your other devices, such as iCloud Drive or what Desktop and Documents hold when they are in iCloud, is listed and never moved, since the Trash would take it from your other devices too: beside a copy on this Mac it is marked Stays, and a group whose every copy syncs is listed under Synced to Other Devices. When a sync app such as Syncthing keeps the folder in step, the copy's note names the app and the entry it keeps at that folder's root, such as~/.stfolder; an entry whose app isn't on this Mac, such as one left after the app was removed or copied over with a folder, holds nothing back. A chosen folder Peel doesn't scan, such as a repository, is named with why, in Scan Settings and with the result. - Installers and Backups: disk images and packages in Downloads, Desktop, Documents, Public, and Shared, and in
the folders directly inside them, where installers are usually left, with archives there that hold an app or an
installer. It also lists the packages and the disk and system images an app keeps in Application Support, and the
images Parallels Desktop and VMware Fusion keep for making virtual machines, with the restore images no VirtualBuddy
machine was installed from marked as unused, macOS installers in Application Support and in the folders Peel reads
apps from, device firmware, downloads never finished, and updates apps downloaded and keep until they install them.
Your iPhone and iPad backups are listed with their size once Peel has Full Disk Access, and never moved. Time
Machine's backups aren't here, and Space explains the snapshots macOS keeps on the disk. Nothing is selected for
you, and Select Recommended takes only what you can download again, such as an installed app's installer, one that
says where it was downloaded from, a macOS installer, device firmware, a download a browser never finished once it
hasn't changed for a day, or an update whose app is closed. It passes by an encrypted disk image, an installer that
is no installed app's and doesn't say where it came from, one that arrived or changed in the last hour, an installer
or an image an app keeps for itself, a download that changed in the last day, a
.partfile no browser left, which a torrent client or another program that resumes downloads may still finish, an update whose app is open, and anything in Shared, open in a program, open as a disk image, or syncing to your other devices. A disk image can also be one you made to keep files in, so look before you select it. An installer, download, or update smaller than 20 MB isn't listed. - iCloud Drive: files already safe in iCloud that are also downloaded to this Mac, as Finder shows them: what is in iCloud Drive, your Desktop and Documents when iCloud Drive keeps them, and each app's documents, never an app's own data. An app's documents are listed and not selected, since Finder may not show them and the app may expect them on this Mac. Downloads are listed in the folders Finder shows them in, named as Finder names them, the biggest first, and a folder's checkbox selects every file in it that Peel recommends; a file that would free less than 1 MB isn't listed. Remove Downloads, as in Finder, takes away only the copy on this Mac: each file stays in iCloud and downloads again when you open it, which takes an internet connection. A file Keep Downloaded is on for in Finder is listed and not selected, since iCloud would download it again at once, and so is a password database or a wallet's keys, which would open again only with an internet connection. A download whose space on disk is shared with the copy iCloud keeps on this Mac once it has uploaded the file, or with another copy, would free nothing, so it isn't listed, and the page says how many there are. The page needs Full Disk Access to see what is kept on this Mac.
- Space: what fills your disk, area by area, and which app or tool each area belongs to.
- File Search: files by name, kind, or size, and by age along with one of them, in your home folder or across this Mac's disks, not network volumes, found through Spotlight, up to 2,000 at a time, so a folder in System Settings > Spotlight > Search Privacy isn't searched, and the page names any disk Spotlight isn't indexing. In the list, the arrow keys choose a file and Space selects it. A file in a Library folder, an app's working data, is listed last and never recommended, and neither is one in a repository, which may be part of a project's work, or in Shared, which belongs to every account, and one that needs an administrator stays where it is. The page says how many files Spotlight found that it doesn't list, and why: what syncs to your other devices, what you excluded, what sits where Peel never moves anything, and what macOS didn't let Peel look at. A file's size is what moving it frees, the list goes by it, and a file that frees less than its length, such as a copy that shares its storage, says so. A file you selected that a newer search no longer lists stays selected, also once the search field is empty, and the page says how many, with Keep Selected and Deselect.
Developer, Build Artifacts, and Space, in detail
Developer: the caches of Xcode, package managers, build systems, editors, cloud and virtual machine tools, game
engines, and AI models. It also lists the graphics caches of Chrome, Chromium, Brave, and Opera, the last update
Google's updater downloaded for each of its apps, the web caches of apps built on Electron, such as Slack or Discord,
and the browser profiles a Playwright run left in the temporary folder when it ended early. It never lists what a
browser or an app keeps for you, a profile a browser still has open, a toolchain, or anything holding an account.
Bazel's build data is found from Bazel 9 on: earlier versions keep it in /private/var/tmp, where Peel doesn't look.
Some of what it lists you may want again, so Select Recommended passes it by: Xcode's archives and the symbols it copied from your devices, model weights, installed packages and the stores your projects load them from, such as pnpm's and Dart's, what a tool keeps for you to install again (Vagrant boxes, Asset Store packages, Godot's export templates), an editor's saved state for a project that no longer exists, the build data of an Xcode project opened in the last week or whose last opening Xcode didn't record, a folder in DerivedData that is neither a cache Xcode names nor one it made for a workspace, a Spring Boot server's folder written to in the last 15 minutes, or the newest one while something still listens on its port, a folder Peel couldn't measure, a copy of CocoaPods' specs that didn't come from CocoaPods, and a cache with a wallet, a signing key, or a password database inside. Nothing is selected for you.
Build Artifacts: what builds left in the folders you choose, like node_modules, DerivedData, target, .nuxt,
__pycache__, Unity's Library, and any folder its tool tagged as a cache (CACHEDIR.TAG), each only when a file of
the tool that makes it proves it. One found with no such file beside it, as Python leaves __pycache__ in every
package, belongs to the project above it: the nearest folder holding a repository or a project's own file, such as
pyproject.toml. Nothing is selected for you, and Select Recommended passes by a project changed in the last 7 days
or whose last change Peel couldn't tell, installed packages (a Python environment, vendor, Terraform's
.terraform), a folder like target whose name says nothing on its own, a Meson build folder, which also keeps the
options its build was set up with, a folder Git tracks files in, such as a Pods folder kept in the repository, which
is part of the project, a folder with a repository, a wallet, or a key inside, one Peel couldn't measure or read, and
one in /Users/Shared, which belongs to every account.
Until you choose a folder, Peel offers ~/Developer, ~/Projects, ~/Code, or ~/src when you have one, and adds
it only when you say so. A chosen folder Peel can't search, such as one on a disk that isn't connected, is named at
the top of the page with the reason, never taken for one with nothing built in it. Peel never searches a hidden
folder, a Library, or a folder a tool fills, such as node_modules, where apps and tools keep what they install, so
choosing one, or a folder inside one, is refused.
Space: what's taking up room, and which app it belongs to. An area smaller than 50 MB isn't listed, unless Peel
couldn't measure part of it or it is open on its page after a move. What an app manages itself, such as Xcode's
simulators, Docker's disk, Rust's toolchains, or Android's NDK versions, Space measures and leaves to that tool, with
the command that frees it, when there is one, for you to copy into Terminal: Peel never runs it, since it deletes for
good. Once Xcode is gone, the Simulators area says to install it again before using its settings. The virtual
machines and Windows bottles of VirtualBuddy, CrossOver, Whisky, Wine, Tart, Lume, Anka, Rancher Desktop, Apple's
container tool, and Genymotion are measured the same way, and once the app that makes them is gone, their area says
to move what you no longer need to the Trash in Finder. In the Library at
the top of the disk, Space also lists the caches and logs apps keep for every account, and the crash reports macOS
keeps. Those an administrator owns go through Peel's helper, and what macOS keeps there for its own services is never
listed. In your own Logs, the folder macOS saves crash reports in stays and only the reports are offered, since macOS
can't make that folder again. What macOS keeps for its own services in your own Caches and Logs is listed, and Select
Recommended passes it by. The logs Homebrew's services write in /opt/homebrew/var/log are offered file by file, and
the folders they sit in stay, since a service expects to find the folder it writes in. What the formulas keep in
Homebrew's var folder (/opt/homebrew/var, or /usr/local/var on an Intel-based Mac), such as a database's data, is
listed folder by folder with its size and only shown, since brew uninstall leaves it: a folder no installed formula
names in its own file says so, and what a formula keeps in Homebrew's etc or in /etc stays where it is. The years
of TeX Live in /usr/local/texlive and the versions of the .NET SDK are shown the same way, each with its size, and
those other than the year in use or with a newer version beside them say so. Where Developer knows part of a folder,
Space says how much of it moves here and opens Developer for the rest. Space also explains the snapshots macOS keeps
on the disk, which Peel never removes, says how much the AI models and datasets Developer lists take, and, on macOS
27, how much Apple Intelligence may keep on this Mac, by Apple's figure.
Nothing is selected for you: Select Recommended takes what Peel could measure in an area and nothing holds back. A cache, or a log in the Library every account shares or in Homebrew's folder, that something wrote to in the last 15 minutes waits for you to select it, since a program may still be using it, and what an open app is still writing to stays until you quit the app. Peel can also warn you, with a notification that opens Space, when less than a tenth of your disk is available: turn it on in Settings > General.
Developer shows what each of your developer tools keeps, folder by folder.
What you select on Orphaned Files, Space, Developer, Build Artifacts, Installers and Backups, Duplicates, and File Search stays selected while you look at the others, and Move to Trash on any of them moves it all at once, as one entry in History. These pages select nothing for you, but for the copies Duplicates selects after a scan you start. A page counts once you have opened it, or once the Select menu in a tool's toolbar, which selects on every page the tool lists, has selected something there, and opens the first of those pages when none is open. The bar at the foot of the page says how many pages that is, and lists them. Move to Trash asks first, naming the first few pages and how many items the others hold.
Look after your Mac
[!TIP] Not sure what something means? Click the ⓘ next to its name, like the one open above beside Scan for Vulnerabilities, for a short explanation in plain words. Next to a file, it tells you why Peel thinks the file belongs to the app.
- Background Items: launch agents and daemons, and the app that added each one, to stop or restart while it runs,
run now or unload while it waits for its time, load, enable or disable, show in Finder, or move to the Trash,
through Peel's helper for those that run as root. One whose program
is gone, or whose command looks unusual, says so. Remove takes out a job a deleted app left loaded,
and an item whose app is in the Trash says that macOS starts it from there each time you log in, until you empty
the Trash. A job an app gave launchd itself, such as an update's installer, says so. One turned off in System
Settings > General > Login Items & Extensions, or waiting for approval there, is only ever stopped here, never
started, not even when its file comes back from History. Edit… beside an agent's file in your own
~/Library/LaunchAgentsopens the file as text: Save moves the file as it was to the Trash, writes yours in its place, and loads the job again if it was loaded, and putting the old file back from History moves your edit to the Trash first. Apps set to open at login are in System Settings > General > Login Items & Extensions, not here. - Extensions: app extensions and system extensions, the app each one came with and whether it is still installed, the choice made for each one, or that macOS decides when nobody chose, which keeps a Finder extension off, and where it is turned on or off: System Settings for most, Safari > Settings > Extensions for a Safari extension, which Safari alone shows the state of, Edit Widgets for a widget, and nowhere for what Shortcuts and Siri use.
- Plug-ins: the plug-ins in the Library folders made for them, from audio units and camera plug-ins to Quick Look, each with the installed app that claims it, or the app Peel saw go whose identifier it bears, and each of which you can move to the Trash, after Peel warns that apps using it may stop working, says that macOS loads a camera plug-in only once legacy video device support has been restored in macOS Recovery, or says that nothing loads it anymore, as for a Quick Look generator, an old Internet plug-in such as Flash, or a contextual menu item.
- Package Receipts: what installer packages other than Apple's put on your startup disk, as their receipts list it, for every account or for yours alone, item by item, to move to the Trash. Nothing is selected for you, and Select Recommended passes by a folder a package made that now holds what something else put there. Forget Receipt moves the receipt itself to the Trash, through Peel's helper where it takes one, so macOS no longer counts the package as installed, and Forget All does so at once for every package listed under Receipt Only, whose receipt lists nothing still on your Mac. An app a package installed follows the rules of its own page, and so does the rest of its package: what is left to Finder or to the maker's uninstaller stays where it is, and what may exist only on this Mac is shown and not selected.
- Intel Software: what still needs Rosetta, which macOS 27 is the last release to offer for most Intel software:
apps, apps built for both that ask macOS to open them as Intel, the Intel-only parts inside other apps, plug-ins,
drivers, background items, the Java runtimes in either Library's
Java/JavaVirtualMachines, and the commands in/usr/local, in MacPorts'/opt/local, and in your home's~/binand~/.local/bin, a MacPorts one with MacPorts' own step,sudo port migrate. It names any folder or program it couldn't read, since something there may need Rosetta too. - Homebrew: your formulae and casks, with Update, Clean Up (and two deeper ones: downloads older than 30 days, or
every download), Repair Taps, Check Health, Scan for Vulnerabilities, Upgrade, and Uninstall, or the command to run in
Terminal for a cask that asks for an administrator's password. Uninstall and the cleanups delete for good, as Homebrew
does, and Peel says so before you confirm them. For a cask whose app Peel leaves alone on the app's own page, such as
one with a system extension, and for a package you excluded, Uninstall stays off, with the reason beside it, and
Upgrade stays off for a package you excluded, since an upgrade deletes the version it replaces. Homebrew
replaces or deletes a cask's app even while it runs, so Peel asks the app to quit first, and opens it again after an
upgrade. It deletes a formula from under what runs from it too, and leaves its
brew servicesjob behind, so the question before Uninstall names what uses the formula and the command that stops the job. On a Mac with Apple silicon, a Homebrew in/usr/localis an Intel one, so Peel runs it through Rosetta and the page says so. A cask Homebrew still lists though its app isn't where Homebrew put it anymore, or, for a cask with no app, its packages are gone, can't be upgraded. It is listed apart under Apps Already Gone, where Forget Cask, or Forget All for every one of them, moves Homebrew's record of it to the Trash, with the links Homebrew made into it in its command and completion folders, so Homebrew stops listing it, and History can put it back. Peel runs Homebrew without your shell's settings, so Homebrew reads its own from~/.homebrew/brew.envthere: a proxy you want it to use, such ashttps_proxy=http://proxy.example:8080, goes in that file.
Fine-tune your Mac
Small tricks that make everyday life on a Mac a little easier. Tweaks gathers 40 settings macOS already has, many of them out of sight, in six groups: Dock, Screenshots, Finder, Typing, Windows, and Privacy. Make a hidden Dock appear at once, save screenshots where you want them and without the floating thumbnail, show hidden files and every file extension in Finder, keep straight quotes as you type, drag a window from anywhere in it, or put seconds on the menu bar clock. Each tweak says what it changes, and turning it off puts back what was there before, or leaves it to macOS. Turn All Off puts back everything Peel changed and leaves what you set yourself as it is. On macOS 27, Privacy also has an Apple Intelligence section: each row opens the place where Apple says to turn that feature off, in System Settings or in the app, and Peel changes none of them.
Set up Terminal
Peel comes with 29 dark themes for Terminal, built on Apple's own Clear Dark. Choose one, and Terminal opens with it in every new window; Put Back gives Terminal the profiles it used before. The same page can leave out the "Last login" line, keep Terminal from reopening its windows, make Option the Meta key and silence the bell in a Peel theme, and show the line that stops the shell from saving its sessions.
It sets up the command line as well:
- A prompt you put together, with a preview, or the one macOS sets.
- Settings zsh, Git, and ssh already have, each with a switch: a longer history shared between windows, Up and Down that find what you started typing, Tab completion with a menu, rebase when pulling, and connections that stay alive.
- Nothing written into your own files. Peel writes the zsh and ssh settings to files of its own, which zsh reads
through one line you add and ssh through two, and changes Git's with
git config. Turning a Git setting off puts back what you had before Peel set it, and one you set yourself goes back to Git's default. Turn All Off undoes what Peel set on each tab, and on the Git tab also what you set yourself. - Tools suggests command-line tools worth having, with the Homebrew command and the lines to add.
TERMINAL.md shows every theme and every setting, with what each one writes.
Stay in control
- History: everything Peel moved to the Trash, ready to put back, from the app and from Terminal alike, and what it was asked to move and wouldn't, with the reason for each item. It puts back what is still in the Trash and keeps the latest 20,000 items, fewer when their paths are very long, saying once how many older removals it no longer lists, and Peel moves no more at once than History can keep. Not Moved keeps the latest 5,000 items and says the same of what it no longer lists. While Peel stays open, Undo in the Edit menu puts back the last removal you made in it.
- Exclusions: files, folders, and apps Peel must never touch. An excluded app still appears in Applications, and
its jobs in Background Items, but Peel won't offer to remove or reset it or act on its jobs, and leaves out of every
page the folders named exactly with its identifier, such as its caches, and an update it downloaded; to keep its
other files, such as plug-ins or a folder named after it, exclude them too. Add them in
Settings > Exclusions, or Control-click a row and choose Exclude from Peel. In Orphaned Files, Control-click a
group and choose This Belongs To…, and Peel stops listing it while the app or the command-line tool you chose is
installed: one Homebrew installed, or a command in
/usr/local/bin, MacPorts'/opt/local/bin, or your home'sbinand.local/bin.
Work your way
Settings > General holds Peel's choices, among them which tools the sidebar shows. Settings also has Exclusions, Privacy, which says what Peel sends and every place it may contact, and Helper.
- Export List of Apps: in the File menu and in Applications' toolbar, what's installed and where each app came from, as JSON, a spreadsheet, plain text, or, with Homebrew 4.4.25 or later installed, a Brewfile.
- Shortcuts: actions that open a page in Peel for you to look at. None of them removes anything.
- Sidebar: turn off the tools you don't use in Settings, and they leave the sidebar. The View menu and Shortcuts still open them. Home, Applications, and History always stay. Background Items, Extensions, Plug-ins, Build Artifacts, Intel Software, and Terminal start turned off, Homebrew starts on only when Homebrew is installed, and iCloud Drive only when it is set up on this Mac; what you turn on or off stays so.
- The
peelcommand: most of what Peel does, from Terminal, as Thepeelcommand says.
With Show in Menu Bar on, Peel's menu bar item lists what each tool found the last time it looked, a line per tool that opens it in Peel. It never adds them up into one figure and never selects anything for you. Turn on Hide from the Dock while no window is open as well, and Peel's icon leaves the Dock when you close its last window, then comes back when you open Peel again from the menu bar, Finder, or Spotlight. While Peel is hidden its icon stays in the Dock, and either that icon or Peel's menu bar item brings it back.
The peel command
- Getting it. The command ships inside Peel. Settings > General shows, beside Command-line tool, the command
that puts it on your path: copy it and run it in Terminal, which asks for your password. It runs
sudo, so on a standard account Peel says it needs an administrator, and gives instead a line to add to your shell's startup file,~/.zshrc,~/.bash_profile, or fish'sconfig.fish, which runs the command from that account alone. A Homebrew install puts it there for you. - It asks first. Every command that moves something shows its plan and asks before it moves anything.
--dry-runonly shows the plan, and-yskips the question. - Only when you can answer. It asks only in a terminal where you can see the plan and type, so with its output
sent to a file or a pipe it needs
-y. It ignores keys typed before the question appeared, and answering no exits with code 2, sopeel uninstall Foo && next-stepstops there. - What the app would do. It moves only what the app would suggest, or a group of orphaned files you name with
peel orphans --remove, through the same checks and into the same History. Anything that needs an administrator is left to the app, and the command won't run undersudo. - For scripts and agents.
apps,leftovers,orphans,caches,projects,duplicates,search,history, andupdatestake--json, which lists and never moves, so--jsonwith--removeis refused rather than guessed at, anduninstall --jsonreports once the move is done: each item and why it stays, what moved, what failed and why, whether the privacy reset happened, the folders Peel couldn't read, and the lines of your shell files that still name what moved.leftovers --jsonanduninstall --dry-run --jsonsay inappStayswhy the app itself would stay, when it would, since none of its files moves then. A size nobody knows isnull, never zero, and what a scan couldn't read is said on standard error too. The exit status says how it ended: 0 when it did what was asked, which for--dry-runis showing the plan, whatever would stay, 1 when something failed or stayed where it was, 2 when you answered no, and 64 when the command is wrong or it would have to ask and can't. - Completions and manual. A Homebrew install sets up its completions for zsh, bash, and fish, and its manual
page,
man peel. Otherwisepeel --generate-completion-script zsh(orbash, orfish) writes the completions for your shell, andman /Applications/Peel.app/Contents/Resources/man/peel.1shows the manual page.
What Peel asks for, and why
Peel opens without any of these and does more with each one. Home, in the picture above, shows which ones are on and takes you straight to the right place in System Settings, or, for the command line, in Peel's Settings.
| Permission | What it lets Peel do |
|---|---|
| Full Disk Access | Look inside the Trash and the private folders where apps keep their data. Without it, Peel can't find everything an app leaves behind. Watch the Trash, the iCloud Drive page, and the list of iPhone and iPad backups need it too. |
| App Management | Move another developer's app to the Trash. Without it, Peel can still clear an app's files, but macOS may refuse to move the app itself. |
| Helper | Move to the Trash, and put back, what sits in folders only an administrator can change, such as an app's leftovers, the caches and logs Space lists for every account, and an installer package's files and receipt, and start, stop, enable, or disable other developers' background items that run as root. It answers administrators only. macOS asks you to approve it once in Login Items & Extensions, and an update of Peel brings its new helper with it. |
| Notifications (optional) | Tell you when your apps have updates, when Homebrew finishes an upgrade or runs into a problem, when your disk is almost full if you turn that warning on, and, with Watch the Trash on, when you move an app to the Trash yourself. While they're off, Settings > General says so under those two switches. |
| Folders macOS asks about | Without Full Disk Access, macOS asks the first time Peel looks in Desktop, Documents, or Downloads for installers, duplicates, what builds left, and what iCloud Drive keeps there, or at your cloud folders to measure them. On macOS 26 it also asks before Peel looks inside another app's data for what it would leave behind; on macOS 27 it refuses without asking, and Peel says which folders it couldn't read. |
| Finder Extension (optional) | Add Uninstall with Peel to the menu you get when you Control-click an app in Finder. |
| Open at Login (optional) | Start Peel when you log in. With Show in Menu Bar on, it keeps running after you close its window, so Watch the Trash keeps working. |
| Command Line (optional) | Use peel from anywhere in Terminal. Home's Copy button, like Settings > General, copies the command that puts it on your path, and Terminal asks for your password when you run it. |
Install the helper from Home, or with Install Helper in Settings > Helper, from an administrator's account, then allow it in System Settings > General > Login Items & Extensions. Once it works, an account that isn't an administrator uses it too: macOS asks for an administrator's name and password once for each action that needs it. If Home says the helper isn't answering, choose Repair there, or Repair Helper in Settings > Helper. If it keeps waiting for approval, the questions in README.md say what to do.
Languages
Peel is in English and translated into 17 languages: Romanian, German, French, Spanish, Portuguese (Brazilian), Italian, Japanese, Chinese (Simplified), Chinese (Traditional), Dutch, Korean, Russian, Polish, Turkish, Swedish, Czech, and Ukrainian. It uses the first language in your Mac's list that it speaks, and English for any other. Each translation uses the words macOS itself uses in that language.
To use Peel in a language other than your Mac's, open System Settings > General > Language & Region, click the Add
button under Applications, choose Peel and a language, then click Add. If Peel is open, quit it and open it again.
The peel command stays in English, since scripts read it.
Uninstall Peel
In Settings > General, choose Remove Peel. Peel then:
- moves the link to the
peelcommand to the Trash, if you made one with the command Settings gives, through its helper when only an administrator can, and has the helper move its own record of what it moved; - removes its helper and its login item;
- moves itself, the files that are certainly its own, and its folder in Application Support to the Trash, all but the Terminal settings zsh and ssh read and anything in it you excluded in Settings. That folder holds History, your exclusions, App Folders, and the settings Peel saved when you reset an app, among others;
- ends its Finder extension, takes its icon out of the Dock, clears its settings, and quits.
Remove Peel takes no step, and says so before you choose it, while Peel itself can't move. From a folder only an administrator can change, log in as an administrator and choose it there, or drag Peel to the Trash in Finder, which asks for one. From the copy macOS runs while Peel is still marked as downloaded, or from its disk image, move Peel to the Applications folder, open it there, and choose Remove Peel. And while its helper is installed, only an administrator's account can remove it, so from another account Peel stays where it is.
If you dragged Peel to the Trash instead, its helper stays registered: System Settings > General > Login Items & Extensions still lists Peel among the apps with background activity. Put Peel back from the Trash in Finder, open it, and choose Remove Peel.
After Remove Peel, what Peel changed for you stays as it is: tweaks, Terminal's theme and its options, the shell and
ssh settings, ~/.hushlogin, Git's settings, the build folders you left out of Time Machine, and the background items
you disabled. Peel leaves the shell and ssh settings in its folder, in Terminal, where the line you added to
~/.zshrc and the two at the end of ~/.ssh/config read them. Turn these off first if you want them gone, or
afterward delete those lines and that folder.
If you installed Peel with Homebrew, Settings shows this command in its place, with a button that copies it. Run it
in Terminal: Homebrew takes Peel off its list of what is installed, deletes the app rather than moving it to the
Trash, stops the helper, asking for an administrator's password, deletes the helper's record of what it moved, and
moves Peel's other files to the Trash, its whole folder in Application Support included. The Terminal settings zsh and
ssh read go with that folder, so the line in ~/.zshrc and the two in ~/.ssh/config then read nothing: turn those
settings off in Peel first, or delete those lines afterward.
brew uninstall --zap --cask peel
When only an administrator can remove the link to the peel command you made with the command Settings gives, and
Peel's helper isn't installed, Remove Peel leaves the link, and Settings says so beforehand. When the helper is
installed but doesn't answer, Remove Peel leaves the link and the helper's record of what it moved, and names both
once it is done. brew uninstall removes only the link Homebrew made. Remove a link that stays yourself:
sudo rm -f /usr/local/bin/peel
Questions
Why does Peel show a smaller size than Finder?
Peel shows what moving an item to the Trash would free, and Finder shows the space it takes. The two differ when files share their space: a copy Finder makes on an APFS disk shares its blocks with the original until one of them changes, and a file can have a second name somewhere else, which keeps it. Peel counts only what would really go. A virtual machine's disk, such as Docker's, is often a sparse file too: Finder shows the size it can grow to, and Peel what it takes on the disk now.
Why does Peel ask for Full Disk Access?
macOS keeps other apps' data, and the Trash, out of sight of any app without it. Peel works without it, but can't see everything an app leaves behind. PRIVACY.md lists the only times Peel goes online.
Is Peel really free?
Yes. Peel is free and open source under the GNU General Public License, with no paid edition, no ads, and no account.
How does Peel update itself?
Choose Check for Updates in the Peel menu or in the menu of Peel's panel in the menu bar, or Install Update in About Peel when it says a new version is out. While Check for app updates is on, Peel also looks once a day, and the panel says when it found one. It shows what is new and installs the update only when you choose, once it has checked that the update is signed as Peel's.
Something in Peel isn't clear. Where can I read more?
Click the ⓘ next to its name. If it's still not clear, open an issue: wording that leaves you guessing is a bug too.