One unified view of everything installed on your Mac.
Atlas builds a local graph of every app, formula, cask, and CLI ・ across Homebrew, zerobrew, the App Store, and manual installs ・ and surfaces it in a fast TUI with lenses for bloat, staleness, Rosetta, duplicates, and updates.
What Atlas shows you
Three questions every Mac user asks occasionally and no tool answers cleanly.
Unified inventory
Apps, CLIs, formulas, casks, and App Store installs collapse into a single searchable list. When the same tool is present in two installers, it's one row ・ attributed to whichever you actually use.
Provenance, not guesses
Every row carries its real source: brew, zerobrew, mas, npm, pipx, uv, or manual. Bundle id, path, arch, size, and last-used date all resolved locally ・ no cloud, no account.
Owner-aware actions
u to update, U for everything, d to uninstall ・ all routed through the actual installer. Manual .app bundles go to Finder's Trash, reversibly. Every action shows the literal command before it runs.
Install
macOS 13+ on Apple Silicon or Intel. A working Rust toolchain is required for v0 while prebuilt binaries are still being wired up.
Lenses
One-keystroke filters over the same inventory. Each answers a question you ask yourself occasionally.
- AllEverything on disk.
- OutdatedItems with a known upgrade available from their installer.
- DuplicatesThe same tool installed through more than one manager.
- BloatTop 50 by disk usage ・ where the bytes actually go.
- Stale.app bundles you haven't opened in 90+ days.
- Rosettax86_64-only apps running under Rosetta on Apple Silicon.
- UnsignedItems missing a valid code signature. On-demand probe.
Docs
Everything you need to drive Atlas from the keyboard or a script. No separate docs site.
Keys
.app to TrashSort modes
Press s to cycle. Great for cleanup ・ find the biggest apps, the ones you never open, the ones you live in.
- biggestLargest on disk first. Fastest way to free GiB.
- longest agoLeast recently opened first. Surfaces dead weight.
- recently usedMost recently opened first. Shows what your Mac actually runs.
- most usedHighest Spotlight use-count ・ your daily drivers.
- least usedNever or barely opened. Cleanup candidates.
CLI ・ for scripts and AI agents
Strictly read-only so a scripted caller can't uninstall anything. Every subcommand accepts --json.
Lenses: all · outdated · duplicates · bloat · stale · rosetta · unsigned
Sources: brew · zb · mas · manual · npm · pipx · uv · cargo
Sort: size · old · recent · frequent · rare · none
For coding agents
Atlas ships a mac-cleanup skill ・ a self-contained markdown file you can drop into Claude Code, Cursor, or any skill-aware agent. It teaches the agent when to invoke Atlas, how to synthesize the JSON output, and how to route uninstalls safely.
→ Install the mac-cleanup skill One-click copy of the skill file and a prompt you paste into your agent.
Positioning
Atlas sits above your package managers. It doesn't want to be one.
what it is
- A unified read-model of everything installed.
- A calmer interface to brew, zerobrew, mas, and `.app` bundles.
- A reproducible manifest of your Mac for migration.
- A set of lenses that surface bloat, staleness, Rosetta, duplicates.
what it is not
- A replacement for Homebrew, or the App Store.
- An MDM, kernel extension, or policy engine.
- A cloud service. Everything stays local.
- A background daemon. Launch it when you need it.