Mac Install Guide · 2026 Development Platform

Get started. Check your macOS version, upgrade your terminal, and install Homebrew. This visual roadmap is your checklist. Click any topic for a tutorial. It's all accurate, human-authored content, not AI.

Check macOS version Compatibility check Latest macOS info

macOS Version

Download macOS Update macOS Upgrade to Tahoe

System preferences Setup resources

Mac Setup

Should I update? macOS Tahoe overview

Mac Command Line

Open Terminal Upgrade terminal Alternative terminals

Terminal App

.zshrc vs .zprofile PATH configuration Shell config files

xcode-select install Check if installed Uninstall CLT Reinstall CLT

Xcode CLT

No developer tools found Apple CLT overview Install via Homebrew

Editor and AI Tools

ChatGPT desktop app

AI Tools

VS Code (coming) Cursor (coming)

Package Management

Update Homebrew Uninstall packages Cleanup old versions Uninstall Homebrew

Install Homebrew

Complete Homebrew guide Best Homebrew packages brew: command not found

Version Control

Git configuration Credential manager

Git Setup

GitHub connection SSH key setup

Programming Languages

Python

System Python Python PATH

Homebrew Python

Update Python

pyenv

Version Managers

uv (modern)

pip not found

Troubleshooting

python not found

Ruby

Check version Update Ruby

Install Ruby

Uninstall Ruby

chruby

Version Managers

Change version

Complete guide

Ruby Guide

Java

Java overview

Install Java

Java 21 LTS

Unable to locate

Troubleshooting

Set JAVA_HOME