"Because your Mac deserves a spa day." ✨
cmm is a modern, interactive, Go-powered terminal utility designed to help you reclaim disk space and keep your macOS running like new. No more hunting through /Library/Caches or manually purging Time Machine snapshots. cmm does the heavy lifting with a polished TUI that makes system maintenance... dare we say, fun?
- 📸 Time Machine Purge: Say goodbye to those bloated local snapshots.
- 🛠️ Xcode Detox: Clear out
DerivedDataand old simulators with one click. - 🍺 Homebrew Hygiene: Cleanup old cellar versions and cache files.
- 🧹 Cache & Log Crusher: Target deep system and user caches safely.
- 🕵️ Interactive Previews: See exactly what's being deleted before you pull the trigger.
- 🎨 Beautiful TUI: Built with Bubble Tea for a premium terminal experience.
To get started, you'll need Go installed on your system.
The easiest way to install cmm is via go install:
go install github.com/david-saint/cmm@latestIf you prefer to build it yourself or want to contribute:
-
Clone the repository:
git clone https://github.com/david-saint/cmm.git cd cmm -
Build the binary:
go build -o cmm main.go
Run the tool interactively:
cmm run- Use the arrow keys to navigate.
- Press Space to select/deselect modules.
- Hit Enter to confirm your cleanup path.
- Look out for Safety Red warnings on "Harsh" cleanup modules—we take your data seriously!
We love contributions! cmm follows a strict Test-Driven Development (TDD) workflow managed via the conductor methodology.
- Pick a task: Check the
conductor/tracks/for open items. - Red Phase: Write a failing test in
pkg/orcmd/. - Green Phase: Implement the minimum code to make it pass.
- Refactor: Clean up your code while keeping the tests green.
- Coverage: Ensure you hit at least 80% code coverage.
Read the full Workflow Guide for more details.
Distributed under the MIT License. See LICENSE for more information.
Built with ❤️ and plenty of ☕️ by David Saint.