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 by default.

v3.1.0 macOS 12.0+ 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

# Make scripts executable
chmod +x *.sh

# Preview what would happen (safe, no changes made)
./brew_setup_tahoe.sh --dry-run

# Run for real when ready
./brew_setup_tahoe.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

# Make scripts executable
chmod +x *.sh

# Preview what would happen (safe, no changes made)
./brew_setup_tahoe.sh --dry-run

# Run for real when ready
./brew_setup_tahoe.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 12.0 (Monterey) or later — Intel or Apple Silicon
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.