Welcome, macOS adventurer! This quest transforms your Mac into a professional-grade development workstation. Youβll install core tooling, tune your terminal, and validate a clean, repeatable setup.
π― Quest Objectives
Primary Objectives (Required for Quest Completion)
- Install Xcode Command Line Tools - Unlock core developer tooling
- Install Homebrew - Your macOS package manager
- Configure a Modern Terminal - iTerm2 + shell enhancements
- Verify Your Toolchain - Confirm Git, SSH, and common utilities
Bonus Objectives (Optional)
- Shell Customization - Prompt themes, aliases, and quality-of-life tweaks
- Baseline Dev Tools - VS Code, Node/Python toolchains, and git config
πΊοΈ Quest Prerequisites
π Knowledge Requirements
- Comfortable using Finder and System Settings
- Basic understanding of command line usage
π οΈ System Requirements
- macOS 12+ recommended
- Administrator access for installs
- Stable internet connection
π Choose Your Adventure Platform
This quest is macOS-only. If youβre on another OS, start with:
π§ββοΈ Chapter 1: Install Core Tooling
β Step 1: Xcode Command Line Tools
xcode-select --install
Verify after installation:
xcode-select -p
β Step 2: Install Homebrew
Run the official installer:
/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"
Then validate:
brew --version
brew doctor
β Step 3: Install Essentials via Scripts
Use the provided helper scripts (review before running):
./hb-install.sh
./hb-packages.sh
π§° Chapter 2: Terminal & Workflow Enhancements
β Step 4: Install iTerm2
./iterminate2.sh
β Step 5: Run the macOS setup helper
./hello-mac.sh
This script walks you through common dev tooling checks and config hints.
π§ͺ Chapter 3: Validate Your Setup
Run these checks to confirm your environment:
git --version
ssh -V
brew list
You should see valid versions for each command.
π Quest Completion Checklist
- Xcode Command Line Tools installed
- Homebrew installed and healthy (
brew doctor) - Terminal upgraded (iTerm2 + shell config)
- Git/SSH verified