Automate your Mac.
Learn the craft.

Educational shell scripts for Homebrew package management on macOS. Set up your Mac the right way while learning professional scripting.

Open source. Production-ready safety. Built for learning.

v3.0.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.

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

Professional tools designed to teach and automate.

🍺

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, comprehensive validation, and idempotent design. Preview every change before it happens.

📦

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

Every function is documented with educational comments explaining shell scripting concepts, patterns, and best practices.

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, an independent developer's collection of apps, tools, and open-source projects. Every script here is built with care, documented for learning, and tested for reliability.

Whether you're setting up a new Mac, learning shell scripting, or automating your development environment, these scripts are designed to be your starting point. Fork, customize, and make them your own.