momenbasel/PureMac
38.3
Weak · 30 September 2026
20.6k
lines of production code
Swift
primary language
2
measurements over time
What this system is
PureMac is a macOS maintenance utility that provides both a graphical interface and a command-line tool for cleaning disk space and managing installed applications. It features an application uninstaller with deep artifact discovery, alongside modules for detecting duplicate files, analyzing storage usage, and removing system junk such as developer caches and language files. The system supports automated updates, multi-language localization, and installation via Homebrew, with a robust release pipeline for code signing and notarization.
Features
Initial Homebrew Cask and Formula for PureMac
Users can now install PureMac via Homebrew. The GUI application is available as a cask (version 3.0.0) for macOS Ventura, which includes a post-install hook to refresh LaunchServices for immediate Dock icon visibility. The command-line interface is available as a formula (version 1.1.1) for macOS Big Sur, allowing terminal-based cleaning of developer caches and artifacts.
homebrew · high confidence
Introduce PureMac CLI for interactive disk cleanup and storage analysis
This change adds the PureMac CLI, a native Swift command-line companion to the PureMac Mac app. It provides an interactive workspace for reviewing and removing developer caches, system junk, AI-tool caches, and Trash via the \puremac clean\ command, with subcategories for dev, junk, ai, and trash. Users can also scan specific project folders for build artifacts using \puremac purge\, browse disk usage in a read-only interactive explorer with \puremac analyze\, and view system memory and storage status with \puremac optimize\. The CLI includes safety features such as an ignore list (\puremac ignore\) to protect paths, configuration management (\puremac config\), and support for dry-run, JSON output, and plain-text modes for non-interactive use.
cli · high confidence
Introduces comprehensive app uninstaller with deep file discovery and cleanup categories
PureMac now includes a full application uninstaller that scans /Applications, \~/Applications, and /Users/Shared to list installed apps while protecting system and Apple apps. It features a heuristic file discovery engine (AppPathFinder) that locates related artifacts across Library, Caches, and Preferences using bundle IDs and app names, with configurable sensitivity and per-app override conditions to handle naming collisions. The tool also adds dedicated cleanup categories for unused language files (.lproj), universal binary thinning (removing unused CPU architectures), and a CLI interface for scanning and listing apps.
PureMac · high confidence
New release tooling and documentation for signing, notarization, and CLI distribution
This change introduces a comprehensive set of scripts and documentation to harden the release process for PureMac. It adds \scripts/release-local.sh\ and \scripts/release-cli-local.sh\ to locally build, sign, and notarize the macOS application and the \puremac\ CLI tool using the App Store Connect API key and Developer ID certificates, ensuring hardened runtime and universal binary support. A new \scripts/SECRETS.md\ documents the required GitHub Actions secrets and provides instructions for extracting filtered certificates and configuring the notary profile. Additionally, \scripts/star-history.mjs\ is added to generate in-repo SVG charts of GitHub star history, replacing the external star-history.com service.
scripts · high confidence
Behavioural changes
PureMac project structure and build configuration overhaul
The PureMac Xcode project has been significantly restructured to support a major feature expansion. The build scheme now explicitly includes the PureMacTests target for testing, running, and profiling. The project file references a large set of new source files, including UI components (OnboardingView, DashboardView, ProtectionView, MenuBarMonitorView), core logic (CleaningEngine, DuplicateFinder, SimilarPhotoFinder, OrphanSafetyPolicy), and utilities (CLI, Logger, Haptics). It also incorporates localization resources for multiple languages (en, fr, pt-BR, pl, ru, uk, zh-Hans, zh-Hant, ja, es, ar) and adds the Sparkle framework for application updates.
PureMac.xcodeproj · high confidence
Test coverage
Added test coverage for core Mac maintenance features
Added new test suites in PureMacTests to verify the correctness of language preferences, application state management, cleaning engine logic, duplicate file detection, localization parity, node cache path validation, performance inspection, and protection auditing.
PureMacTests · high confidence
Dependencies
Introduce Swift Package Manager manifest for the puremac CLI tool
Added the Package.swift manifest file to define the puremac command-line interface, specifying a macOS 11+ target and integrating the swift-argument-parser library (version 1.3.0) to handle command-line argument parsing.
(dependencies) · high confidence
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 64 → 38 (-25.3)
- Rubric changed (rubric-2026.09.11 → rubric-2026.09.18) — scores are not directly comparable.
Lenses
- Code Health 85 → 86 (+1.8)
- Architecture 97 → 99 (+1.6)
- Maturity 61 → 61 (-0.0)
- Readiness 53 → 49 (-3.7)
- Security 75 → 75 (+0.0)
- Event-Driven 10 (new)
- Performance 100 (new)
Resolved (13)
- Documentation: no usage examples (docs/README.ar.md)
- Duplicated block (10–21 lines × 3) (PureMac/Services/ScanEngine.swift)
- Duplicated block (22–30 lines × 2) (PureMac/Services/ScanEngine.swift)
- Duplicated block (6 lines × 4) (PureMac/Views/Tools/PerformanceView.swift)
- Duplicated block (7 lines × 3) (PureMac/Views/Tools/PerformanceView.swift)
- Duplicated block (8 lines × 2) (PureMac/Views/Tools/PerformanceView.swift)
- Hotspot: cli/Sources/puremac/Commands/Analyze.swift (cli/Sources/puremac/Commands/Analyze.swift)
- Hotspot: cli/Sources/puremac/Commands/Clean.swift (cli/Sources/puremac/Commands/Clean.swift)
- Hotspot: cli/Sources/puremac/Commands/Purge.swift (cli/Sources/puremac/Commands/Purge.swift)
- Hotspot: cli/Sources/puremac/Core/Safety.swift (cli/Sources/puremac/Core/Safety.swift)
- Members sharing a duplicated core (4 members, 50+ identical tokens) (PureMac/Logic/Scanning/Locations.swift)
- Members sharing a duplicated core (4 members, 50+ identical tokens) (PureMac/Views/Tools/PerformanceView.swift)
- Off-boarding risk: anonymized user #1
New (29)
- Coverage not measured — Swift suite
- Dependency hygiene PARTLY measured — SwiftPM pinning read, dependency currency NOT established
- Documentation: hard to navigate (docs/ui-prototype/new.html)
- Documentation: no architecture or design documentation (docs/llms.txt)
- Duplicated block (10 lines × 2) (PureMac/Views/MainWindow.swift)
- Duplicated block (11 lines × 2) (PureMac/Views/MainWindow.swift)
- Duplicated block (11–13 lines × 2) (PureMac/Views/Tools/PerformanceView.swift)
- Duplicated block (14 lines × 2) (PureMac/Views/Tools/SimilarPhotosView.swift)
- Duplicated block (18 lines × 2) (PureMac/Models/Models.swift)
- Duplicated block (22 lines × 2) (PureMac/Views/Apps/AppFilesView.swift)
- Duplicated block (22–30 lines × 2) (PureMac/Services/ScanEngine.swift)
- Duplicated block (28 lines × 2) (PureMac/Views/Tools/SimilarPhotosView.swift)
- Duplicated block (6 lines × 2) (PureMac/Views/Tools/AppUpdatesView.swift)
- Duplicated block (6 lines × 8) (PureMac/Views/MainWindow.swift)
- Duplicated block (7 lines × 2) (PureMac/Views/OnboardingView.swift)
- Duplicated block (7 lines × 2) (PureMac/Views/Tools/SimilarPhotosView.swift)
- Duplicated block (7 lines × 5) (PureMac/Views/MainWindow.swift)
- Duplicated block (7–10 lines × 4) (PureMac/Logic/Scanning/Locations.swift)
- Duplicated block (7–14 lines × 4) (PureMac/Services/ScanEngine.swift)
- Duplicated block (8 lines × 2) (PureMac/Views/Tools/ProtectionView.swift)
- …and 9 more
Changes since last survey
- 17 commits — 17 feature/other, 0 fixes
By area
- assets/star-history-dark.svg — 16 commits
- (root) — 1 commit
Notable commits
- change: Add JMacy link
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
- change: chore: refresh star history
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
momenbasel/PureMac was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 30 September 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit ccf8f843ee159615e491b8ae1f30ac3f1f580975 — the exact code this score is about.
- Scored under rubric-2026.09.18 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer preprod-cb25ca4feafa.