Support for dush for Mac
Need a hand?
Something looks wrong, or you're not sure why dush did that? Start here.
Report a problem
Problems with dush for Mac go in the dush issue tracker on Codeberg, which the app shares with the command-line tool. You need a Codeberg account to open an issue. Issues are public, so look over what you paste for names and paths you'd rather keep to yourself.
A good report says it's about the Mac app, which versions of dush and macOS you have, what you did, what you expected and what happened instead.
To reach a person directly:
What you need
- macOS 26 or later.
- For Safe to delete?, a Mac that supports Apple Intelligence, with Apple Intelligence turned on in System Settings. The rest of dush works without it.
Questions
Why does dush ask for my disk, and what does it do with that access?
macOS keeps apps out of your disk until you say so. A folder you drop or choose needs nothing more. Caches & Temp, Downloads & Desktop and Developer Caches look in places you didn't pick, so dush asks you to choose your startup disk once, in the system's panel.
With that access, dush reads the names, sizes and dates of files and folders. It doesn't read what's inside your files, and it never changes them. It keeps the access read-only, on this Mac.
Full Disk Access is a separate, optional step. It lets dush measure the folders macOS keeps private too, like the Trash and Safari's caches. Only you can turn it on, in System Settings. The Privacy Policy has the whole picture.
Why are some paths left out of the totals?
dush can only measure what macOS lets it read. A path it can't read is left out of the totals, and a banner on the results says how many. They're usually folders macOS keeps private, another account's files, or a file system that fails to list them, like a paired iPhone's.
Full Disk Access, in Settings › Privacy, lets dush read some of them. The banner gives only the count, because dush doesn't keep those paths.
Anything you excluded, in a scan's options or in Settings › Exclusions, is left out too.
Why can an Apple Intelligence answer be wrong?
It's a small model running on your Mac, and it never sees what's inside your files. It works from details like the path, the size and a few names. So it can misjudge what an item is, and it can't know what matters to you.
Take a verdict as a starting point, and look at the item yourself before you decide. The app shows what the model was told, under the answer.
How do I clear the history?
Choose Clear History… at the bottom of the sidebar or in Settings › General. dush asks first, then removes its saved scans. Your files stay exactly where they are. Remembered Apple Intelligence answers stay too.
For a single scan, use Remove from History. To stop saving scans, turn off Save completed scans in Settings › General.
dush never deletes files. If you decide to remove something, that's always your own step, in Finder or Terminal.