Agent skill · software engineering · aradotso
puremac-macos-cleaner
Free open-source macOS cleaner built with SwiftUI — CleanMyMac alternative with zero telemetry, scheduled auto-cleaning, and Xcode/Homebrew/system cache cleanup.
Why this skill is useful
Provides specific implementation details and category definitions for cleaning system junk that the AI wouldn't reliably generate on its own.
What it needs
Requires homebrew installed locally. About 7k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
PureMac macOS Cleaner Skill by ara.so — Daily 2026 Skills collection. PureMac is a free, native SwiftUI macOS application that cleans system junk, user caches, Xcode derived data, Homebrew caches, mail attachments, and purgeable APFS space. It is a privacy-respecting, open-source alternative to CleanMyMac X with no telemetry, no subscriptions, and no network calls. --- Install Homebrew (recommended) Direct Download Download the latest .app from Releases, unzip, and drag to /Applications. Build from Source Requirements: macOS 13.0+, Swift 5.9, Xcode 15+. --- Project Structure --- Core Concepts Clean Categories PureMac operates on named categories, each mapping to specific filesystem paths: Category Key Paths --- --- System Junk /Library/Caches, /Library/Logs, /tmp, ~/Library/Logs User Cache ~/Library/Caches, npm/pip/yarn/pnpm caches Mail Attachments ~/Library/Mail Downloads Trash ~/.Trash Large & Old Files ~/Downloads, ~/Documents, ~/Desktop (>100 MB or >1 year old) Purgeable Space APFS Time Machine snapshots via tmutil Xcode Junk DerivedData, Archives, CoreSimulator/Caches Homebrew Cache ~/Library/Caches/Homebrew Large & Old Files are never auto-selected — the user must explicitly choose items before cleaning. --- Working with the Codebase Adding a New Clean Category 1. Define the category in CleanCategory.swift: 2. Add scanning logic in ScannerService.swift: 3. Add cleaning logic in CleanerService.swift: --- Scheduled Auto-Cleaning Configure via Settings → Schedule tab. Intervals: hourly, 3h, 6h, 12h, daily, weekly, biweekly, monthly. Enable scheduling programmatically: --- Purgeable Space (APFS Snapshots) PureMac uses tmutil to delete local Time Machine snapshots — this is the only operation requiring elevated privileges: --- Xcode Cache Paths Scan these and safely delete their contents without removing the directories themselves. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/puremac-macos-cleaner