Start Here

If you are new to this repo, use this order.

1) Install on Current Mac

• Main entrypoint: ./install.sh (auto-detects macOS and calls unified mac installer)
• Direct unified installer: ./os/mac/install.sh
• Non-interactive mode (accept default prompts): ./os/mac/install.sh --yes
• Optional OS defaults script: ./os/mac/setup_macos_preferences.sh

Then run:

scripts/dev-check.sh

2) Learn the Tools Quickly

Open: - Mac Workstation Guide - Local AI Setup - Tool Tutorials - Docs Site Setup - Modern CLI Tools - Mac Setup + Local AI

3) Daily Commands

• Update system and packages: scripts/update.sh
• Sync dotfiles symlinks/config: scripts/sync.sh
• Health check: scripts/dev-check.sh
• Set wallpaper: scripts/wallpapers/set-wallpaper.sh

4) New Mac Mini Setup (next week)

Use: - New Mac Mini Checklist