The New Mac Setup Marathon - Why It Takes 5 Hours and the Step Everyone Forgets

Fazm Team··2 min read

The New Mac Setup Marathon

You just unboxed a new Mac. You think setup will take an hour. It will take five. And the first mistake happens in the first five minutes.

Step Zero - The One Everyone Forgets

You open Terminal and type brew install something. It fails. Homebrew is not installed. So you paste the Homebrew install script. It also fails - or at least stalls - because Homebrew needs Xcode Command Line Tools, and those are not installed either.

The correct order is:

  1. xcode-select --install (wait 10 to 20 minutes for download)
  2. Install Homebrew
  3. Everything else

Skip step 1 and you will spend 30 minutes debugging why nothing works. The error messages are not helpful. They mention missing headers, missing compilers, missing SDKs - none of which point you back to the actual fix.

The Full Timeline

Here is what the first 5 hours actually look like:

  • Hour 1 - Xcode CLI tools, Homebrew, basic terminal setup (zsh, oh-my-zsh or starship)
  • Hour 2 - Development tools (Node, Python, Rust, Swift toolchain updates)
  • Hour 3 - Editor setup, extensions, themes, keybindings
  • Hour 4 - Git config, SSH keys, GPG keys, GitHub authentication
  • Hour 5 - Project-specific dependencies, local databases, Docker, environment variables

And this assumes everything goes smoothly. If you are setting up for AI agent development, add another hour for Claude Code, MCP servers, and accessibility permissions.

Automate What You Can

After your third new Mac setup, you start keeping a script. A setup.sh that installs everything in the right order. The smart move is to version control it and update it every time you add a new tool to your workflow.

The even smarter move is to let an AI agent handle the boring parts. But first, you need Xcode CLI tools installed. There is no escaping step zero.

More on This Topic

Fazm is an open source macOS AI agent. Open source on GitHub.

Related Posts