📦 Version: v1.0
MSS is a lightweight, terminal-based tool for macOS designed to clean, fix, and maintain your system — whether you're a home user or a technician. It simplifies common tasks like freeing up disk space, checking system status, and updating apps.
- 🧹 Cleans out hidden system junk (logs, cache, temp files)
- 🌐 Clears DNS cache to fix slow or broken internet
- 🗑️ Empties Trash and clears user cache folders
- 🧠 Displays system info (macOS version, uptime, etc.)
- 🔧 Checks disk health
- 📦 Updates software via Homebrew and mas-cli (if installed)
- 📥 Optionally installs missing tools like Homebrew or mas-cli
- 📜 Generates a detailed activity log for review
- 📺 Easy-to-read ASCII menu interface — beginner friendly
- macOS 10.13 (High Sierra) or newer
- Admin privileges (Terminal will prompt for your login password)
- Must be run in Terminal
-
Double-click the
.shfile once to let macOS verify it
(System Preferences → Security & Privacy → General may prompt you to allow it) -
Open Terminal (
⌘ + Space, then typeTerminal) -
Make the script executable:
chmod +x <drag script file into Terminal>
-
Run the script:
Double click the program and you're good to go. -
When prompted for your password, enter the password you use to log in to your Mac (nothing will appear as you type — that's normal)
✅ Done — the script is ready to use!
💡 Tip: After the initial chmod step, you can just double-click the file in Finder to launch it like an app.
If your Mac is slow, cluttered, or acting up, this script gives you a clean, consistent way to troubleshoot and maintain it — with no bloat, no third-party GUIs, and no technical experience required.
Great for personal users, IT support, and field techs alike.
This script runs system-level operations for cleaning and diagnostics. Use at your own risk.
Review the code before using it on production machines.
