Repository navigation
Releases
DiskPilot 0.6.3
DiskPilot 0.6.3 scans more than twice as fast, moves files to the Trash much faster with live progress, and updates every number the moment a cleanup finishes.
Download
DiskPilot.dmg. One universal app for Apple silicon and Intel Macs, macOS 11 or later. Signed with a Developer ID and notarized by Apple.
Coming from 0.6.0 or later: DiskPilot shows a banner when the update is ready; install it with one click.
What's changed
Faster
- Scanning a home folder takes about 15 seconds instead of about 40 on our test Mac. DiskPilot no longer opens the thousands of empty folders inside other apps' containers, where macOS checks every folder opened. Results are the same.
- Moving files to the Trash is much faster: DiskPilot no longer waits on Finder for each file. A progress bar, the amount moved and the file being handled show while it works.
- Long lists open and scroll smoothly. Files by type and Largest items show 100 rows a page, Duplicates 50 sets a page, and the cleanup review 50 items a page.
- The window no longer redraws everything many times a second while a scan runs, and thumbnails for the rows you are looking at load first.
Numbers update at once
- After a cleanup or emptying the Trash, the totals, categories, folder sizes, Largest items, Files by type and Cleanup change straight away. No scan needed.
- Items moved to the Trash count in the Trash until you empty it, since they still use disk space.
Quieter
- DiskPilot moves items to the Trash itself instead of asking Finder, so Finder's Trash sound no longer plays for every batch. Items are in the Trash as usual and can be dragged back out, but Finder may not offer Put Back for them.
- New, soft sounds: a quiet tone while a scan runs, and a gentle chime when a scan or cleanup finishes. Nothing plays while the window is hidden. Turn them off in Settings > Appearance.
Keyboard shortcuts
- ⌘1 to ⌘8 open each page in the sidebar, and ⌘, opens Settings.
- ⌘R scans again, ⌘. stops a scan, and ⌘F filters the list on the page.
- ⌘/ shows every shortcut. It is also in Settings > About.
Install with Homebrew
brew tap devanshgoel-123/tap
brew trust devanshgoel-123/tap
brew install --cask diskpilotVerify the download
SHA-256 of DiskPilot.dmg:
9ccad43829ef29096e32778bdc473db5fe09bcaf42b8f451270d4009eb78a516
Check it with shasum -a 256 DiskPilot.dmg.
To confirm this DMG was built by this repository's release workflow:
gh attestation verify DiskPilot.dmg -R Devanshgoel-123/diskpilot
DiskPilot 0.6.2
DiskPilot 0.6.2 lists much smaller files in Files by type, so thousands of photos and screenshots that add up can be reviewed and cleared.
Download
DiskPilot.dmg. One universal app for Apple silicon and Intel Macs, macOS 11 or later. Signed with a Developer ID and notarized by Apple.
Coming from 0.6.0 or 0.6.1: DiskPilot shows a banner when the update is ready; install it with one click.
What's changed
Files by type
- Files of 25 KB or more are now listed, up to 2,000 per type. Until now only files of 1 MB or more were, so a folder of 2,000 photos could show just a few dozen of them.
- A note above the list says which files are shown and why the rest are not: smaller than 25 KB, or beyond the 2,000 largest. Every file still counts in the type's total.
- Rescan once after updating to see the smaller files. Results saved by earlier versions list only files of 1 MB or more.
Verify the download
SHA-256 of DiskPilot.dmg:
be6cf00092f5bcc52db5fc0639fa68e1242373e59fd4c649e7548f558330016a
Check it with shasum -a 256 DiskPilot.dmg.
To confirm this DMG was built by this repository's release workflow:
gh attestation verify DiskPilot.dmg -R Devanshgoel-123/diskpilot
DiskPilot 0.6.1
DiskPilot 0.6.1 lets you act on a file straight from its preview: select it for the Trash, or open it in its own app.
Download
DiskPilot.dmg. One universal app for Apple silicon and Intel Macs, macOS 11 or later. Signed with a Developer ID and notarized by Apple.
On 0.6.0, DiskPilot offers this update itself: click Update in the banner, or check now in Settings > Updates. Coming from 0.5.1 or earlier: quit DiskPilot, then drag the new version into Applications and replace the old one. Your history, settings and saved results are kept.
What's changed
See before you remove
- In the preview, in Files by type or Duplicates, Select for Trash adds the file to your selection, and pressing it again takes it out. Command-Delete does the same. Nothing moves to the Trash until you review your selection, as before. The copy you are keeping in a duplicate group cannot be selected.
- Click the large image, or press Command-O, to open the file in its own app: Preview for photos, QuickTime for videos. DiskPilot opens only photos, videos, audio and documents it listed, never apps, scripts, installers, disk images or archives. For those, use Show in Finder.
Install with Homebrew
brew tap devanshgoel-123/tap
brew trust devanshgoel-123/tap
brew install --cask diskpilotVerify the download
SHA-256 of DiskPilot.dmg:
baed03f31538067290fd4ab77247b9bd9255d7aeb2b6f35a5984283e368d69a3
Check it with shasum -a 256 DiskPilot.dmg.
To confirm this DMG was built by this repository's release workflow:
gh attestation verify DiskPilot.dmg -R Devanshgoel-123/diskpilot
DiskPilot 0.6.0
DiskPilot 0.6.0 keeps itself up to date, groups your videos, images and installers by type, shows previews before you remove anything, keeps count of the space you have cleared, can rescan on a schedule and remind you once a week, and recognises browser, chat app and Go storage.
Download
DiskPilot.dmg. One universal app for Apple silicon and Intel Macs, macOS 11 or later. Signed with a Developer ID and notarized by Apple.
Coming from 0.5.1 or earlier: quit DiskPilot, then drag the new version into Applications and replace the old one. This is the last time you need to do that by hand. Your history, settings and saved results are kept.
What's changed
Updates inside the app
- DiskPilot checks for a new version once a day and shows a banner when one is ready. Install it with one click; DiskPilot restarts on the new version.
- Every update is signed, and DiskPilot checks the signature before installing anything.
- After an update, "What's new" shows what changed. Turn the daily check off, or check now, in Settings > Updates.
Files by type
- A new By type tab in Storage groups your own videos, images, audio, archives, installers and documents, with the total for each.
- Filter by folder (Downloads, Desktop and so on), by name, or by files you have not changed in 6 months or a year.
- Select several files, review them, and move them to the Trash in one go. These are your files, so DiskPilot never calls them safe to delete: you decide.
- Files inside apps, ~/Library, hidden folders, Photos and Final Cut libraries, and project build output are left out, including
build,distandoutfolders in any git project.
Space cleared and streaks
- History shows how much space DiskPilot has cleared on your Mac, how many cleanups that took, and your weekly streak: weeks in a row with at least one cleanup. The Overview shows the same in one line.
- Deleted and trashed space both count; emptying the Trash is not counted twice. These numbers stay on your Mac and are not sent anywhere.
- The scans list groups scans by day and shows how much the folder grew or shrank since its previous scan. Only cancelled or failed scans are marked.
In the background
All off until you turn them on, in Settings > In the background. DiskPilot never removes anything on its own.
- Open at login: DiskPilot starts in the menu bar when you log in, without opening its window.
- Rescan automatically every day or every week, so the results are never old. Scanning only reads.
- A weekly reminder: once a week, during the day, a notification says how much is likely safe to clear and how your cleanup streak is going. macOS asks once whether DiskPilot may send notifications.
- These run while DiskPilot is open or in the menu bar.
See before you remove
- Duplicates shows a thumbnail of every copy. Press Space for a large preview, like Quick Look, and the arrow keys to move between files. The same preview works in Files by type.
- Previews are made only for files DiskPilot listed, never for anything else on your Mac.
Docker
- Stop a running container from the Containers table with one click.
- Remove a running container in one step: DiskPilot stops it, then removes it.
- When you remove a container, DiskPilot lists the volumes it uses. Tick the ones you also want deleted and type the container's name to confirm. Volumes another container uses are kept.
- Delete a volume that no container uses, after typing its name to confirm. Volumes in use cannot be deleted.
- A container started with
--rmis deleted by Docker as soon as it stops. DiskPilot says so, and will not stop one whose anonymous volumes would be deleted with it. - DiskPilot runs exactly the commands you reviewed: if Docker changed in the meantime, it asks you to review again.
- A container that takes a long time to shut down is given time to stop, and DiskPilot says it is still stopping instead of reporting a failure.
Recognises more
- Browser caches for Chrome, Brave, Edge, Arc, Chromium and Vivaldi in every profile, and the web caches of apps such as Slack, Discord and Notion. Quit the browser or app first. Data that sites keep for offline use is listed separately, to review first.
- Telegram's media cache and WhatsApp media. DiskPilot never removes either: an Open Telegram or Open WhatsApp button takes you to the app, where you clear it, so the app's own records stay intact. WhatsApp media is never suggested for removal.
- Playwright browsers, and tool versions installed with asdf or mise.
- Go: the build cache can be cleared, and the module cache is shown with Go's own command to clear it, since Go makes it read-only. A Go analyzer also finds caches you moved with
go env -w. Contributed by @chinmayajha, DiskPilot's first outside contributor.
Faster scans
- DiskPilot reads each folder's contents in one request to macOS instead of looking up every file separately. On a home folder of about 770,000 files, everything outside app containers is measured about 20% faster.
Safer
- Deleting a folder now stops before anything is removed if any part of it could not be deleted: read-only folders, locked files, items with access rules, or a read-only folder around it. It used to remove part of the folder and leave the rest.
- Empty Trash now removes folders that tools such as Go and DotSlash make read-only. It used to fail on them with "Permission denied" every time.
- Moving items to the Trash works even if you did not let DiskPilot control Finder. It used to fail with "Not authorized to send Apple events". Finder may not offer Put Back for those items, but you can still drag them out of the Trash.
- Duplicates and Files by type no longer offer files inside Cardboard, ScreenFlow, Aperture, iPhoto and Capture One projects, the Music, TV and Photo Booth libraries, or virtual machines, which their apps need.
- If Go's build cache is set to a folder other tools also use, DiskPilot no longer offers to remove that folder.
- The available space shown in the window stays current while it is open, so it matches the menu bar. It used to update only after a scan or emptying the Trash.
Install with Homebrew
brew tap devanshgoel-123/tap
brew trust devanshgoel-123/tap
brew install --cask diskpilotVerify the download
SHA-256 of DiskPilot.dmg:
c44e7a458b88aef5382ca76c8c2d6b9ae81ff4845070fa0462bc04cf296b88d4
Check it with shasum -a 256 DiskPilot.dmg.
To confirm this DMG was built by this repository's release workflow:
gh attestation verify DiskPilot.dmg -R Devanshgoel-123/diskpilot
DiskPilot 0.5.1
DiskPilot 0.5.1 is the first release signed with a Developer ID and notarized by Apple, so it opens without a security warning. Results also arrive much sooner, the app is smaller, and the optional assistant works with OpenAI and OpenRouter as well as Anthropic.
Download
DiskPilot.dmg. One universal app for Apple silicon and Intel Macs, macOS 11 or later.
To update, quit DiskPilot, then drag the new version into Applications and replace the old one. Your history, settings and saved results are kept.
What's changed
Opens without a warning
- DiskPilot is now signed with a Developer ID and notarized by Apple. macOS opens it like any other downloaded app, with no trip to Privacy & Security.
Results sooner
- macOS checks every folder DiskPilot opens inside other apps' private storage (
~/Library/Containers), one at a time, and on many Macs that is most of the scan. DiskPilot now measures those folders last and shows everything else as soon as it is done. On our test Mac, with about 800,000 files in the home folder, results appear after about 8 seconds instead of about 35, and a progress bar shows the remaining app folders while their totals are added. - Cleanup plans made from these early results stay valid: every item is checked again before anything is moved.
Smaller app
- The app is built for size, which makes the program itself about 21% smaller with the same scan speed.
Assistant
- Choose Anthropic, OpenAI or OpenRouter in Settings, with your own key for each, kept in the macOS Keychain. Each key is sent only to its own provider over HTTPS. OpenAI and OpenRouter list their models live, showing only models that can use DiskPilot's read-only tools.
- The assistant is still off until you turn it on, and it still cannot delete, move or run anything.
Recognises more
- iPhone and iPad backups appear as one item per device, always marked for review.
- Flutter, Unity, Unreal, Podman, Minikube and Windsurf storage is now recognised, and Windsurf joins the editor analyzers.
Install with Homebrew
brew tap devanshgoel-123/tap
brew trust devanshgoel-123/tap
brew install --cask diskpilotVerify the download
SHA-256 of DiskPilot.dmg:
b58437d7e722007d146af0f70f65ccc6d5e0620afa9a223a02d70cbe49685b19
Check it with shasum -a 256 DiskPilot.dmg.
To confirm this DMG was built by this repository's release workflow:
gh attestation verify DiskPilot.dmg -R Devanshgoel-123/diskpilot
DiskPilot 0.4.2
DiskPilot 0.4.2 gives the menu bar item a new icon that shows how full your disk is, and makes the optional assistant easier to find.
Download
DiskPilot.dmg. One universal app for Apple silicon and Intel Macs, macOS 11 or later.
To update, quit DiskPilot, then drag the new version into Applications and replace the old one. Your history, settings and saved results are kept. If macOS says it cannot verify the developer, open System Settings > Privacy & Security and select Open Anyway once.
What's changed
Menu bar
- The menu bar icon is now a ring around DiskPilot's goggles that fills as your startup disk fills, so you can see how full the disk is without opening anything. It updates in the background and follows the light or dark menu bar.
Assistant
- After a scan, Overview mentions the optional assistant and links straight to its settings. It answers questions such as "What can I safely clean up?" using your own Anthropic API key, kept in the macOS Keychain. It can only read DiskPilot's results, and anything it suggests opens in Cleanup for you to review. Choose Not now to hide the note for good.
- The assistant stays off until you turn it on, and nothing changes for people who don't use it.
Verify the download
SHA-256 of DiskPilot.dmg:
0dcffb885f2d96d735e87e591270775a38621a9cbd38ef6af880094db3feb1cb
Check it with shasum -a 256 DiskPilot.dmg.
To confirm this DMG was built by this repository's release workflow:
gh attestation verify DiskPilot.dmg -R Devanshgoel-123/diskpilot
DiskPilot 0.4.1
DiskPilot 0.4.1 is a security release. It tightens what the assistant can see, which programs DiskPilot will run, and the checks made just before anything is removed. There are no new features, and updating is recommended.
Download
DiskPilot.dmg. One universal app for Apple silicon and Intel Macs, macOS 11 or later.
To update, quit DiskPilot, then drag the new version into Applications and replace the old one. Your history, settings and saved results are kept. If macOS says it cannot verify the developer, open System Settings > Privacy & Security and select Open Anyway once.
What's changed
Privacy
- The assistant could see the names of files inside Mail, Messages, iCloud Drive and other private folders when a folder was named with different capitalization, such as
~/library/mail. It now sees those folders only as a single total, however they are spelled. - The assistant treats file, folder, app and image names as data. Instructions written into a name are not followed, and the only commands it suggests are the ones DiskPilot provides.
- Docker's container details hide the values of environment variables, which often hold passwords and API keys. Variable names are still shown.
Programs DiskPilot runs
- DiskPilot only runs a
dockerprogram signed with an Apple Developer ID, such as Docker Desktop's or OrbStack's, or one installed by Homebrew. Adockerfile placed in a folder like~/.docker/binby another program is ignored, so it can never run with the access you gave DiskPilot. - Xcode's simulator tools now time out instead of stalling Developer Tools when the simulator service hangs.
Safer cleanup
- When you remove duplicates, DiskPilot checks again, just before moving each extra copy, that the copy you are keeping is still there and identical. If it changed or is gone, the extra copy stays.
- Empty Trash removes only the exact items you reviewed. If a different item has taken a reviewed item's name since then, it is left in the Trash.
- Permanent delete refuses a folder that contains another mounted disk, such as a disk image, instead of erasing that disk's contents too.
- Two cleanup previews made at the same moment can no longer be mixed up.
Fixes
- Open on GitHub in Settings works again.
This release is built from the tagged source by the Release workflow on GitHub Actions. It now also carries a signed record of the commit and workflow that built it, and published release files can no longer be replaced.
Verify the download
SHA-256 of DiskPilot.dmg:
a1c302a321b5c1d21deb48af5cd810f7cf983f4b703d78574a51685a1bbb0c26
Check it with shasum -a 256 DiskPilot.dmg.
To confirm this DMG was built by this repository's release workflow:
gh attestation verify DiskPilot.dmg -R Devanshgoel-123/diskpilot
DiskPilot 0.4.0
DiskPilot 0.4.0 finds duplicate files and local AI models, measures the private folders macOS protects once you allow it, and puts everything that frees space in one place.
Download
DiskPilot.dmg. One universal app for Apple silicon and Intel Macs, macOS 11 or later.
To update, quit DiskPilot, then drag the new version into Applications and replace the old one. Your history, settings and saved results are kept. If macOS says it cannot verify the developer, open System Settings > Privacy & Security and select Open Anyway once.
What's new
Duplicates
- Duplicates finds files with identical contents: same size first, then a SHA-256 of the contents. Files under 1 MB, hidden folders,
~/Library, app bundles, dependency folders and package caches are skipped. - You choose which copy stays. One copy of every set always stays, and each copy is compared byte for byte with it again just before it is moved to the Trash.
- Hard links are counted once, and APFS clones are marked "No space to free", because removing a clone gives back little or nothing.
Private folders and Full Disk Access
- Mail, Messages, Photos, iCloud Drive and Safari are often among the largest folders on a Mac, and macOS only lets an app measure them with Full Disk Access. The Overview now says which private folders were not measured and opens the right page in System Settings.
- Sizes are measured on this Mac and nothing leaves it. If you use the assistant, it sees each private folder only as a single total, never the names of the files inside.
For developers
- Local AI models: Ollama and LM Studio model stores are measured on the Developer Tools page, and Ollama layers no model uses any more, or left over from interrupted downloads, are suggested for the Trash.
- Credentials in AI transcripts: Developer Tools can check Claude Code, Codex CLI and Gemini CLI transcripts on this Mac for API keys, tokens and private keys that were pasted or printed into a session. Values are always shown masked, and nothing is sent anywhere.
Simpler layout
- Storage now has two tabs: Folders to browse by size, and Largest items (previously the Large Files page).
- The sidebar is grouped into finding space (Storage, Duplicates, Applications, Developer Tools, Docker) and getting it back (Cleanup, History).
- The Overview shows how much is waiting in the Trash, with Empty Trash next to it. Cleanup moves items to the Trash so they stay recoverable, and the space comes back once the Trash is emptied.
- A menu bar item shows the space available on your startup disk and opens Cleanup, Duplicates or Empty Trash. Closing the window keeps it running; Quit DiskPilot ends the app.
Removed
- Starting and stopping Docker containers. DiskPilot's Docker page is for seeing and reclaiming space; use Docker Desktop to run containers.
Everything still runs locally, with no account and no telemetry.
This release is built from the tagged source by the Release workflow on GitHub Actions.
Verify the download
SHA-256 of DiskPilot.dmg:
eac2111e55652022b658c823133c80f0a9847561c0d35bf3ea7694995f1c4dab
Check it with shasum -a 256 DiskPilot.dmg.
DiskPilot 0.3.0
DiskPilot 0.3.0 can empty the Trash for you, and shows exactly what it is removing while it does.
Download
DiskPilot.dmg. One universal app for Apple silicon and Intel Macs, macOS 11 or later.
To update, quit DiskPilot, then drag the new version into Applications and replace the old one. Your history, settings and saved results are kept. If macOS says it cannot verify the developer, open System Settings > Privacy & Security and select Open Anyway once.
What's new
Empty Trash
- Empty Trash is on the Cleanup page and shows how much space the Trash is using. It is also offered right after you move items to the Trash.
- Before anything is deleted you see the space you will get back, the number of files, and the items themselves, largest first. Nothing happens until you choose Empty Trash.
- Only the items in that preview are deleted. Anything you move to the Trash afterwards is left alone, and an item that is no longer there is skipped.
- Progress is real: the amount reclaimed and the file count come from the deletion as it happens. Stop finishes the current file and leaves everything else in the Trash.
- When it is done you see the space reclaimed and files removed. If some items could not be removed, for example locked files or files owned by another user, each one is listed with the reason and stays in the Trash.
- Every run is recorded in Cleanup History.
macOS keeps the Trash private. To empty it from DiskPilot, turn on DiskPilot in System Settings > Privacy & Security > Full Disk Access. DiskPilot explains this and opens the right page if access is missing.
Deletion never follows links out of the Trash and never crosses onto another volume. The Trash on external drives is not included.
Everything still runs locally, with no account and no telemetry.
This release is built from the tagged source by the Release workflow on GitHub Actions.
Verify the download
SHA-256 of DiskPilot.dmg:
c16bccdbffaafea42c89e2e3936ec4b32113c2af71fc9a9ade52a7a83606d1e4
Check it with shasum -a 256 DiskPilot.dmg.
DiskPilot 0.2.0
DiskPilot 0.2.0 remembers your last scan and points out older versions and other things you no longer need.
Download
DiskPilot.dmg. One universal app for Apple silicon and Intel Macs, macOS 11 or later.
To update, quit DiskPilot, then drag the new version into Applications and replace the old one. Your history and settings are kept. If macOS says it cannot verify the developer, open System Settings > Privacy & Security and select Open Anyway once.
What's new
Saved results
- The last scan is saved on your Mac, so DiskPilot opens straight to your results. A new scan runs only when you click Scan.
- Results older than a day show their age and a Rescan button.
- When you review a cleanup, every item is measured again on disk, and anything already gone is left out, so the total is current.
- Only folder names and sizes are saved, never file contents. Settings > Saved results > Clear results removes them.
Older versions and leftovers
Cleanup now marks items with a tag and the evidence behind it, and can show one kind at a time:
- Older version: a newer version is installed next to it. Covers JetBrains IDEs and Android Studio, Xcode device support, Android build tools and NDK, Gradle, Node.js (nvm), Python (pyenv), Ruby (rbenv), Homebrew, and Claude Code and Cursor command-line versions.
- Leftover: the app, extension or project it belonged to is no longer there.
- Installer: a disk image or package in Downloads for an app that is already installed.
- Duplicate: a "name (1)" download that is identical, byte for byte, to the original.
The default or in-use version is never marked. Python, Ruby and Homebrew versions come with a command to run yourself instead of a remove button, because other environments can depend on them. Findings under 1 MB are listed in Developer Tools but not suggested in Cleanup.
Smaller changes
- The developer-tools analysis runs automatically after each scan, so its findings appear in Cleanup without opening Developer Tools first.
- Cleanup details no longer show "0 files" for items found by the analyzers.
Everything still runs locally, with no account and no telemetry.
This release is built from the tagged source by the Release workflow on GitHub Actions.
Verify the download
SHA-256 of DiskPilot.dmg:
de230d41037d9d0a38cc76d4a89067b67b054de2bb86f579ba0775d592e3cb9a
Check it with shasum -a 256 DiskPilot.dmg.