Automate your Mac.
Learn the craft.

Shell scripts for installing, updating, and cleaning up Homebrew on macOS — with the source code commented so you can read what each one does before you run it.

Open-source. MIT-licensed. Dry-run built into every script.

v4.1.1 macOS 11+ · 15+ recommended MIT License Apple Silicon Ready
⚠️

Use at Your Own Risk

These scripts modify your system by installing software, changing shell configurations, and creating scheduled tasks. They are provided "as is" without warranty. Always back up your system before use, review the code before running, and use --dry-run to preview changes first. See the full Terms of Service for details.

What is Homebrew? Homebrew is a free, open-source package manager for macOS — like an app store for your terminal. Instead of downloading installers from the web, you run one command and Homebrew handles the rest.

How to Use

Two ways to get started. Pick whichever you prefer.

Option A

Download Everything

Best if you want the full toolkit.

# Download and unzip
curl -L -o brewscripts.zip https://github.com/DJCastle/homeBrewScripts/archive/refs/heads/main.zip
unzip brewscripts.zip && cd homeBrewScripts-main

# Preview what would happen (safe, installs nothing)
./brew-setup.sh --dry-run

# Run for real when ready
./brew-setup.sh
Option B

Clone with Git

Best if you want to stay updated or contribute.

# Clone the repository
git clone https://github.com/DJCastle/homeBrewScripts.git
cd homeBrewScripts

# Preview what would happen (safe, installs nothing)
./brew-setup.sh --dry-run

# Run for real when ready
./brew-setup.sh

Scripts Library

Browse individual scripts. Download only what you need, or grab them all above.

Loading scripts library...

What You Get

A handful of focused scripts. No frameworks, no daemons.

🍺

Interactive Setup

Full Homebrew installation with architecture detection, shell configuration, and guided app selection. Works on Intel and Apple Silicon.

🛡️

Safety First

Dry-run mode, interactive checkpoints, and idempotent design. You can preview every change before it runs, and re-run safely if something goes sideways.

📦

App Management

Batch install development tools, productivity apps, creative software, and utilities. Fully configurable through a single config file.

🔄

Auto Updates

Scheduled Homebrew updates with network and power awareness. Runs only when conditions are right.

📱

Smart Notifications

Email reports and text message summaries for automated updates. Stay informed without babysitting your scripts.

🎓

Learn While You Build

Functions are commented inline. If you want to know what a script is doing — or copy a pattern into your own work — the source explains itself.

Requirements

What you need before running these scripts.

●
macOS 11 (Big Sur) or later — Intel or Apple Silicon. macOS 15 (Sequoia) or later is recommended: below that Homebrew publishes no prebuilt packages, so everything compiles from source. Tested through macOS 27 (Golden Gate).
●
Administrator privileges — you'll be prompted for your password
●
Internet connection — for downloading Homebrew and packages
●
Terminal access — Applications → Utilities → Terminal
●
At least 1 GB free disk space — for Homebrew and installed apps

About

Brew Scripts is part of CodeCraftedApps, a small collection of independent tools and open-source projects.

These scripts are what I actually use to set up new Macs and keep existing ones up to date. They're MIT-licensed — fork them, change them, ship your own version.