purge-app README

项目的 README,来自 github.com/jithin-sabu/purge-app。合并为一个 markdown 文件:README.md。

Purge app icon

Purge

Free up your Mac. Safely.

English | 简体中文 | Русский | Українська

A free, open-source native Mac app that clears the cache and junk your Mac piles up on its own.
Files go to the Trash by default, so you can put them back.

Website Build status License: MIT Latest release Total downloads GitHub stars

jithin-sabu/purge-app | Trendshift

Download  ·  Install guide  ·  Build from source  ·  Security

Purge scanning a Mac for safe-to-clean cache

Your Mac quietly fills up with cache and junk you never see and never asked for. Purge finds it, marks what is safe, and clears it in one click.

[!NOTE] Files and folders go to the Trash by default, and Purge never empties the Trash, so you can put them back until you empty it yourself. Deleted permanently: iOS simulators and simulator runtimes, through Xcode's simctl; Xcode's optional Metal Toolchain, through xcodebuild -deleteComponent (Xcode downloads it again when a project needs it); Time Machine local snapshots, through tmutil (Purge keeps the newest and the one from your last backup); the Apple Intelligence models on macOS 27, which Apple's asset service releases and Purge can download again; command-line tools and Homebrew cask apps that their package manager uninstalls, when you choose that in the review sheet. Docker Desktop's folder goes to the Trash. Purge does not run docker system prune.

You do not need to understand any of it to use it. But if you ever want to check, every item carries a plain-language explanation and a safety label, so nothing gets touched that you cannot see and verify first.


Features

Overview

App Caches

Scans ~/Library/Caches, sandbox container caches (these need Full Disk Access), and common system junk:

Dev Tools

Five groups in one view:

Simulators, runtimes and Xcode components are always Check First. They are deleted permanently, not moved to the Trash, and their section headers say so.

In Settings → Cleaning, choose Projects count as stale after (1 month to 2 years, or Show all) to control which projects appear. Age is measured from the last time anything in the project changed, including git activity, not from the date on node_modules or target. A project in use right now, with a terminal or dev server running inside it or a git command in progress, never appears.

Git worktrees made by AI coding tools (Cursor, Codex, Conductor, T3 Code, and Claude Code) appear under Orphaned Git Worktrees only once their repository no longer lists them. A worktree Git still uses never appears however old it is, and neither does one a terminal or agent is working inside.

Large Files

Find space-hogging personal files without digging through folders:

Large Files is separate from cache cleanup: these are your personal files, not rebuildable caches.

Restore images, virtual machines, and unfinished downloads

Some big files carry a label that says what they are. Hover it for the full explanation.

Local AI models

Downloaded models are often the largest files on a Mac and are easy to forget. They appear in Large Files under the AI Models category, one row per model, named the way you installed it, with the app or library that downloaded it as the location. Purge knows the stores of Ollama, LM Studio, the Hugging Face Hub cache (~/.cache/huggingface/hub; HF_HOME and HF_HUB_CACHE are honoured when they are set for apps, not only in a shell profile), swift-transformers, apps that keep models under ~/Library/Caches/huggingface, PyTorch Hub, Whisper, GPT4All, Jan, DiffusionBee and Draw Things. Weight files over 100 MB in ~/Library/Caches, ~/Library/Application Support and ~/.cache that belong to no known store are listed too, by the folder they sit in, so you can tell which app downloaded them.

Purge understands Ollama's content-addressed storage, so a model's size counts only the bytes that would actually be reclaimed rather than blobs shared with another model. A Hugging Face model is its whole cache folder, so a blob two snapshots share is counted once and never removed from under the other. Models always go to the Trash and are never part of Clean Safe Items or a scheduled clean. When an app keeps its own list of installed models that Purge can't update, the row says the app may still show the model as installed.

App Uninstaller

Dragging an app to the Trash leaves most of it behind: caches, preferences, containers, saved state, logs, cookies and website data, and login helpers pile up on disk. The Uninstaller removes the app and those leftovers in one pass.

The Uninstaller has two more lists beside Installed Apps. Each appears when its scan finds something:

Safety labels

Purge assigns a safety label to every item it recognizes:

Label Meaning
✅ Safe to Clean Known cache or rebuildable artifact, safe to remove
⚠️ Check First May be safe, but could cause inconvenience

Filter with All, Safe to Clean, or Check First (⌥⌘1–⌥⌘3). Sort by size, date modified, or name.

Unidentified folders are left out of the list entirely. Purge only shows what it knows about.

The labels and explanations are there to be checked, not read cover to cover. Select the safe items and clean them, or open the reasoning behind any single row first. Either way is fine.

Cleaning

Settings

Settings is a tab in the sidebar (⌘,) with five groups:

More

Keyboard shortcuts

Shortcut Action
⌘R Scan the current tab (Scan Everything on the Overview)
⇧⌘R Scan Everything, from any tab
⌘1–⌘5 Go to Overview, App Caches, Dev Tools, Large Files, or App Uninstaller
⌥⌘1–⌥⌘3 Filter by All, Safe to Clean, or Check First, on App Caches and Dev Tools
⌘F Search on Large Files and App Uninstaller
⌘, Open Settings

Download

Download Purge


Installation

There are two ways to install Purge: with Homebrew if you live in the terminal, or by downloading the app directly. Both land in the same place.

Install with Homebrew

brew install --cask purge

This installs Purge from the official Homebrew cask, and Homebrew verifies the download's checksum for you automatically.

Install manually

The steps below walk through the direct download.

Step 1: Download

Click the download link above and download the .dmg.

[!TIP] Since Purge deletes files, verifying the checksum confirms your download is byte-for-byte the one that was published, with nothing altered in transit.

Each release includes a matching .dmg.sha256 checksum file. Download both the .dmg and its .dmg.sha256 file into the same folder, then in Terminal:

cd ~/Downloads
shasum -a 256 -c Purgev*.dmg.sha256

A result ending in OK means the file matches the published release.

Step 3: Install

Open the .dmg and drag Purge to your Applications folder.

Step 4: Open Purge

Double-click Purge to open it. Purge is notarized by Apple, so it opens normally with no extra steps.

Step 5: Let Purge look deeper (optional)

Purge works without Full Disk Access: it scans App Caches and Dev Tools. With it, Purge also finds App Store apps' caches, large files, installed apps and deleted apps' leftovers.

  1. At the end of the first run, or later from Look deeper, click Let Purge in. System Settings opens
  2. Find Purge in the list and turn on its switch
  3. Come back to Purge. It notices the change by itself. If macOS offers to reopen Purge, go ahead

Choose Not now to skip it. You can turn the access off anytime in System Settings.


Updating

Purge updates itself in place. Once a day it checks for a new version, and when one is available the update window appears with the release notes. Choose Install Update and Purge downloads it, verifies its signature, installs it, and relaunches. You don't need to visit the release page or drag anything.

By default nothing is installed without your confirmation. You can also check whenever you like from the About screen, and if you'd rather Purge didn't check on its own, turn off Check for updates automatically in Settings → Updates and History.

If you'd rather not be asked, turn on Install updates automatically in the same place, or tick the matching box in the update window. New versions then download in the background and install the next time Purge quits. Once one is ready, Restart to Update in the Purge menu, the menu bar menu or the About screen installs it straight away. That helps if you keep Purge in the menu bar and rarely quit it.

Updates are delivered through Sparkle, the standard update framework for Mac apps outside the App Store. Each update is signed with a key that lives only on the developer's machine, and Purge refuses any download that doesn't carry a matching signature.

Updating with Homebrew

If you installed through Homebrew, you can update from the terminal instead:

brew upgrade --cask purge

Either route is fine. Your settings, cleaning schedule, and history are kept whichever way you update; they live separately from the app. You won't need to grant Full Disk Access again either, since the permission stays with Purge.

You can also browse past versions on the releases page anytime.


Uninstalling

Choose Uninstall Purge… in the Purge menu, or Settings → Uninstall → Uninstall…. Purge lists what it runs in the background on your Mac (the deleted-app watcher, the admin helper, the Finder right-click item, the cleanup reminder and launch at login), turns each one off and checks it really stopped, then moves itself to the Trash and quits.

Your settings and cleaning history stay on your Mac, so a reinstall picks up where you left off. Tick Also move settings and history to the Trash to move them too. Nothing is deleted permanently; you empty the Trash when you're ready.

macOS doesn't let an app remove its own Full Disk Access. If Purge had it, the last screen offers Quit and Open Full Disk Access. In System Settings, select Purge and click the minus button.

Already dragged Purge to the Trash? Download it again, open it, and choose Uninstall Purge…, so nothing it ran keeps running. To check nothing is left, Purge should be gone from System Settings → General → Login Items & Extensions, and this should print nothing:

pgrep -fl io.getpurge

Build from source

Prefer to build Purge yourself instead of downloading the release? Here is how.

Prerequisites

Dependencies are resolved by Swift Package Manager when you first build. The only one is Sparkle, which handles in-app updates.

Step 1: Clone the repo

git clone https://github.com/jithin-sabu/purge-app.git
cd purge-app

Step 2: Build and run

Open the project in Xcode and run:

open purge.xcodeproj

Then select the purge scheme and press ⌘R.

The project is set to sign with the developer's Developer ID certificate, which you won't have. In Xcode, open Signing & Capabilities for each target and choose your own team or Sign to Run Locally.

Or build straight from the command line, with signing turned off:

# Build a Debug app
xcodebuild -project purge.xcodeproj -scheme purge -configuration Debug build CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO

# Build a Release app
xcodebuild -project purge.xcodeproj -scheme purge -configuration Release build CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO

The built Purge.app is written under Xcode's DerivedData folder (the build output ends with its path). macOS treats each build without your signature as a new app, so Full Disk Access has to be granted again after a rebuild.

Optional: regenerate brand icons

The app cache icons are generated from simple-icons. To rebuild them:

npm install
npm run generate:icons

Running the tests

xcodebuild test -project purge.xcodeproj -scheme purge -destination 'platform=macOS' CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO

The signing flags matter: without a development certificate on the machine, the test build fails before a single test runs. Continuous integration builds the same way.


Requirements


Privacy

Purge runs entirely on your Mac. Your excluded folders, cleaning history and last scan stay in its Application Support folder, and your settings in its preferences. Nothing is uploaded. The last scan is saved so Purge has something to show while it scans again. Nothing from Desktop, Documents, Downloads or iCloud is written to it, and Large Files keeps only its totals, by kind of file, never a file name.

The one time Purge talks to the network is the update check: once a day it fetches a small XML file from GitHub to see whether a newer version is available. It sends nothing about you or your Mac, and you can turn it off in Settings → Updates and History.

Purge reads some file contents, on your Mac only. To find duplicates it compares files of the same size byte for byte. To work out which app or tool a file belongs to, it reads small files such as an app's Info.plist, LaunchAgent plists, and the scripts that start command-line tools. It never sends file contents anywhere.

Purge does not use AI. Nothing you scan or clean is sent to an AI service.


Security

Purge deletes files, so safety is the point. A few things worth knowing:

Found a safety gap or a path that could be deleted when it shouldn't be? Please report it. See SECURITY.md for how.


Contributing

Bug reports, safety findings, and pull requests are welcome. CONTRIBUTING.md covers how to set up the project and what makes a change easy to review. Anything touching the safety allowlist, the never-delete protections, or the scanning logic gets extra scrutiny and takes longer to review, which is deliberate.

Security issues are the exception: report those privately through SECURITY.md rather than opening an issue.


License

Purge is released under the MIT License. You are free to use, read, modify, and distribute it.


Support

Purge is free. If it saved you some disk space, you can chip in toward the running costs from the About screen inside the app, or directly at Buy Me a Coffee.

Buy me a coffee


Jithin Sabu

Website LinkedIn X Email

purge-app (jithin-sabu/purge-app)

正在搜索数据库…

这是什么?一款免费开源的原生 Mac 应用,可自动找出 Mac 积累的缓存和垃圾文件,并一键清理。默认情况下,文件会移入废纸篓,因此你可以把它们恢复回来。
它是 Mac 应用还是命令行工具?它是一款使用 Swift 和 SwiftUI 构建的图形界面 macOS 应用,而不是命令行工具。你打开它,查看各个类别,然后在界面中清理项目。
我该怎么运行它?README 中链接了一份下载应用的安装指南;如果你想自己编译,还有一份单独的从源码构建指南。
要完整运行是否需要任何权限?需要。“大文件”功能和应用扫描都需要“完全磁盘访问权限”;没有该权限的话,只会扫描“应用缓存”和“开发工具”。
它会永久删除东西吗?会,但只限特定情况。大多数项目会移入废纸篓,而 Purge 从不清空废纸篓。不过,iOS 模拟器、Time Machine 本地快照以及 Homebrew cask 应用(当你在审核面板中选择 Homebrew 时)会被永久删除。
它支持哪些 Mac?README 没有说明最低支持的 macOS 版本。其中的 Apple Intelligence 模型清理功能专门需要运行在 Apple 芯片上的 macOS 27。
App Uninstaller 有什么用?把应用拖到废纸篓会留下它的缓存、偏好设置、容器和日志。Uninstaller 可以一次性同时删除应用及这些残留文件,而且它删除的所有内容仍会移入废纸篓。
Purge 会运行 docker system prune 吗?不会。Docker Desktop 的文件夹会移入废纸篓,Purge 不会运行 docker system prune。
“大文件”能找到什么?它会扫描“文稿”“桌面”“下载”“影片”“音乐”和“图片”文件夹,查找较大的个人文件;同时还会列出重复文件、虚拟机、未完成的下载以及本地 AI 模型,并可按大小和最近使用时间筛选。
大小
291.2 MB
星标
2K
时长
6个月
提交 · 90 天