Atlas for Mac

Explainable, recovery-first Mac maintenance workspace.

English | 简体中文

Atlas for Mac is a native macOS application for people who need to understand why their Mac is slow, full, or disorganized, then take safe and reversible action. The current MVP unifies system overview, Smart Clean, app uninstall workflows, permissions guidance, history, and recovery into a single desktop workspace.

This repository is the working source for the new Atlas for Mac product. Atlas for Mac itself is open source under the MIT License. It remains an independent project and may reuse selected upstream Mole capabilities under the MIT License, but user-facing naming, release materials, and product direction are Atlas-first.

Disclaimer

Atlas for Mac is an independent open-source project. It is not affiliated with, endorsed by, or sponsored by Apple, the upstream Mole authors, or any other commercial Mac utility vendor. Some components in this repository may reuse or adapt upstream Mole code under the MIT License; when such code ships, the related attribution and third-party notices must remain available. Cleanup, uninstall, and recovery actions can affect local files, caches, and app data, so review findings and recovery options before execution. Recoverable actions remain reviewable in Atlas, but physical on-disk restore is only available when a supported recovery path exists.

Installation

Download

Download the latest release from the Releases page:

• .dmg — Recommended. Open the disk image and drag Atlas to your Applications folder.
• .zip — Extract and move Atlas.app to your Applications folder.
• .pkg — Run the installer package for guided installation.

Prefer the latest non-prerelease release if you want the normal public install path. GitHub prereleases may contain development-signed builds intended for testing; those builds can require Open Anyway or a right-click Open flow before launch.

If you install a prerelease and macOS blocks the app, you will see a warning similar to this in System Settings -> Privacy & Security:

Requirements

• macOS 14.0 (Sonoma) or later
• Apple Silicon or Intel Mac

Build from Source

git clone https://github.com/CSZHK/CleanMyPc.git
cd CleanMyPc
swift run --package-path Apps AtlasApp

Or open in Xcode:

brew install xcodegen
xcodegen generate
open Atlas.xcodeproj

Note

: Atlas release assets can be either Developer ID signed + notarized or development prerelease builds, depending on the release. If you install a prerelease or a local build, macOS may require Open Anyway or a right-click Open flow before launch.

MVP Modules

• Overview
• Smart Clean
• Apps
• History
• Recovery
• Permissions
• Settings

Product Principles

• Explain recommendations before execution.
• Prefer recovery-backed actions over permanent deletion.
• Keep recovery claims honest: not every recoverable item is physically restorable on disk.
• Keep permission requests least-privilege and contextual.
• Preserve a native macOS app shell with worker and helper boundaries.
• Support 简体中文 and English, with 简体中文 as the default app language.

Screens

Overview	Smart Clean

Apps	History

Repository Layout

• Apps/ — macOS app target and app-facing entry points
• Packages/ — shared domain, application, design system, protocol, and feature packages
• XPC/ — worker service targets
• Helpers/ — privileged helper targets
• Testing/ — shared testing support and UI automation repro targets
• Docs/ — product, architecture, planning, attribution, and execution documentation

Local Development

Run the app

swift run --package-path Apps AtlasApp

Open the native Xcode project

xcodegen generate
open Atlas.xcodeproj

Build the native app bundle

./scripts/atlas/build-native.sh

Package .zip, .dmg, and .pkg artifacts

./scripts/atlas/ensure-local-signing-identity.sh
./scripts/atlas/package-native.sh

The local signing step is recommended on machines that do not have Apple release certificates. It gives local and prerelease builds a stable development signature instead of falling back to ad hoc packaging.

Run focused tests

swift test --package-path Packages
swift test --package-path Apps

Refresh README Media

./scripts/atlas/export-readme-assets.sh

This exports the configured app icon and current app-shell screenshots into Docs/Media/README/.

Author & Contact

• Developer: Lizi KK
• Role: Ex-Baidu & Alibaba Tech Lead · atomstorm.ai Founder
• Website: AtomStorm Studio
• X (Twitter): x.com/lizikk_zhu
• Discord: discord.gg/aR2kF8Xman
• GitHub Repository: CSZHK/CleanMyPc
• Issues: github.com/CSZHK/CleanMyPc/issues
• Security Contact: cszhk0310@gmail.com for private vulnerability reports. See SECURITY.md.

More Socials

WeChat Official Account	Xiaohongshu

Attribution

Atlas for Mac is an independent MIT-licensed open-source project. This repository builds in part on the open-source project Mole by tw93 and contributors, and still contains upstream Mole code and adapters used as implementation input. If upstream-derived code ships, keep Docs/ATTRIBUTION.md and Docs/THIRD_PARTY_NOTICES.md in sync with shipped artifacts.