https://github.com/prasit-chanda/brew-maintenance
brew-maintenance.zsh is a free, all-in-one script for macOS that keeps your Homebrew setup healthy by checking dependencies, fixing issues, updating everything, cleaning up old files, and showing you exactly how much space you saved—all with one easy command.
https://github.com/prasit-chanda/brew-maintenance
cleanup dependencies fix free homebrew macos update zsh
Last synced: about 1 year ago
JSON representation
brew-maintenance.zsh is a free, all-in-one script for macOS that keeps your Homebrew setup healthy by checking dependencies, fixing issues, updating everything, cleaning up old files, and showing you exactly how much space you saved—all with one easy command.
- Host: GitHub
- URL: https://github.com/prasit-chanda/brew-maintenance
- Owner: prasit-chanda
- License: apache-2.0
- Created: 2025-06-05T19:19:58.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-30T10:43:00.000Z (about 1 year ago)
- Last Synced: 2025-06-30T11:45:39.420Z (about 1 year ago)
- Topics: cleanup, dependencies, fix, free, homebrew, macos, update, zsh
- Language: Shell
- Homepage:
- Size: 88.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ॐ नमः शिवाय
# 🍺 Brew it your way
**Script:** `brew-maintenance.zsh`
**Author:** Prasit Chanda
**Platform:** macOS
---
## 🤷 Overview
Meet `brew-maintenance.zsh` — your **no-cost Mac savior** disguised as a humble shell script.
It’s the all-in-one magic wand that keeps your **Homebrew ecosystem less embarrassing** and
your Mac feeling like it just got back from a spa retreat. One command, and voilà — it’ll
**sniff out outdated packages**, **fix broken links**, **massage your permissions**, and even
**wrangle Xcode into behaving**. It’ll **upgrade everything it can get its hands on**,
**relink mission-critical tools** like `brew`, `git`, `python3`, and `node` (because who needs
things actually working, right?). Then, it **cleans up the digital junk drawer** and tells you
how much disk space you just heroically reclaimed. Bonus? You get a **color-coded log** so pretty
it might actually make you *want* to read your terminal output.
---
## 🧠 Key Features
**🎁 Totally Free:** 100% free for all Mac users.
**🤹 Automatic Checks:** Ensures Homebrew and Xcode tools are ready before starting.
**🛠️ Fixes & Repairs:** Repairs permissions, broken links, and unlinked formulae.
**⚙️ Updates Everything:** Updates and upgrades all formulae and casks.
**🔗 Relinks Tools:** Automatically relinks essential tools if needed.
**✨ Cleans Up:** Removes outdated files and reports disk space freed.
**📟 Clear Output:** Color-coded, step-by-step messages for every action.
**📝 Full Log:** Saves a timestamped log file for every session.
---
## 👀 What You See
**🧩 Decorative Header:** Stylish start with date and system details.
**🏃♂️ Step-by-Step Progress:** Clear, color-coded messages for each maintenance stage.
**✍️ Summary:** Total disk space freed and a link to your log file.
---
## 💡 How to Use
1. **Download:** Save the script as `brew-maintenance.zsh` in your workspace.
2. **Make Executable:**
```sh
chmod +x brew-maintenance.zsh
```
3. **Run the Script:**
```sh
./brew-maintenance.zsh
```
4. **Check Logs:**
A log file is created in the folder where you run the script.
---
꧁⋆༺𓆩 Keep your Mac and Homebrew clean, fast, and up-to-date — all for 𓆪༻⋆꧂