Atlas for Mac

Explainable, recovery-first Mac maintenance workspace.

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.

MVP Modules

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

Product Principles

• Explain recommendations before execution.
• Prefer recovery-backed actions over permanent deletion.
• 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/package-native.sh

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/.

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.