gitwtfhub

wtf is mclean?

maclifevn/mclean — explained in plain English

Analysis updated 2026-05-18

45SwiftAudience · generalComplexity · 2/5LicenseSetup · moderate

TL;DR

A free macOS app that finds and clears junk files, fully uninstalls apps, and shows disk usage as a bubble map, with no telemetry.

Mindmap

Mindmap is still cooking. Refresh in a few.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Scan your Mac for system junk, app caches, and old files to free up disk space.

REASON 2

Completely uninstall an app along with its leftover preferences and cache files.

REASON 3

Visualize what is filling up your disk using a bubble map of folder sizes.

REASON 4

Find leftover files from apps you deleted a long time ago.

What's in the stack?

SwiftSwiftUImacOS

How it stacks up

maclifevn/mcleanwondaggvcb-oss/lazy-bear-desktopfatwang2/pulse
Stars454647
LanguageSwiftSwiftSwift
Setup difficultymoderatemoderateeasy
Complexity2/52/52/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

No prebuilt download is available yet, running it requires building from source with Xcode 16+.

Wtf does this do

MClean is a free, open source app for macOS that helps you reclaim disk space by clearing out junk files, fully uninstalling apps, and visualizing what is taking up room on your drive. It runs on macOS 13 and newer, works on both Apple Silicon and Intel Macs, and the whole app is only about 11 MB. The Smart Scan feature checks ten categories at once, including system junk, app caches, files from AI tools like Ollama and LM Studio, Mail data, the Trash, large or old files, Xcode junk, and cache from Brew, Node, and Docker. Results are shown broken down by category and nothing is deleted automatically, you review and select what you want cleaned. Large or old files, meaning over 100 MB or older than a year, are never pre-selected for you. A feature called Space Lens scans your Home folder or any other folder and shows disk usage as a bubble map sized to actual bytes used. You can click into a bubble to explore a folder more deeply, use a breadcrumb trail to go back, and select items from a list to send to the Trash. For removing an app completely, MClean uses a ten layer matching system, checking things like the app's bundle ID, group identifiers, entitlements, and file metadata, to find every related file scattered across your Mac: preferences, caches, containers, launch agents, and logs. This is meant to remove an app in one pass without needing a separate uninstaller tool. There is also a feature that scans your Library folder for leftover files from apps you already deleted long ago, and an optional scheduled cleanup that runs in the background on a set interval. The developer states a few commitments: deleted files always go to the Trash rather than being permanently removed outright, the app collects no analytics or crash reports and makes no network calls, and it avoids alarming or exaggerated warnings. MClean needs Full Disk Access permission to reach certain protected areas of macOS, and the README states that without this permission, cleanup would miss around 70 percent of what it could otherwise find. Building the app yourself requires Xcode 16 or newer.

Yoink these prompts

Prompt 1
Walk me through building MClean from source using Xcode and xcodegen.
Prompt 2
Explain what Full Disk Access permission MClean needs and why cleanup misses files without it.
Prompt 3
Help me understand how Space Lens visualizes my folder sizes as a bubble map.
Prompt 4
Show me how MClean's ten-layer matching system finds all the files left behind by an uninstalled app.

Frequently asked questions

wtf is mclean?

A free macOS app that finds and clears junk files, fully uninstalls apps, and shows disk usage as a bubble map, with no telemetry.

What language is mclean written in?

Mainly Swift. The stack also includes Swift, SwiftUI, macOS.

How hard is mclean to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mclean for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.