Skip to content

Hello Mac

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: - Hello Windows - Hello Linux - Hello Cloud

🧙‍♂️ 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

📚 References & Resources

🕸️ Knowledge Graph

Structured wiki-links connect this quest to the IT-Journey knowledge graph. Open the Obsidian Graph View to explore connections.

Level hub: [[Level 0000 - Foundation & Init World]] Overworld: [[🏰 Overworld - Master Quest Map]] Recommended: [[Hello n00b: Your First Steps into the IT Journey]] · [[OS Selection]] Unlocks: [[VS Code Mastery Quest: Forge Your Ultimate Development Weapon]] · [[Terminal Fundamentals: Command Line Navigation Quest]] Sequel quests: [[VS Code Mastery Quest: Forge Your Ultimate Development Weapon]] Parallel quests: [[Hello Windows: Mastering the Windows Development Environment]] · [[Linux Fundamentals]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]