🍎 macOS Dev Setup: The AI-Powered Developer Workspace

The ultimate foundation for setting up a complete, modern, and ultra-productive macOS environment from scratch, with zero manual intervention ("zero-touch").

Much more than a simple installation script, this repository configures a true AI-first workstation tailored for mobile/web development (Kotlin, Compose, Node, Rust) using the declarative elegance of a Brewfile.

✨ Why use this setup?

• 🤖 AI-First: Integrates the best local and remote AI tools by default (Ollama, LM Studio, Claude, Gemini CLI, AICommit2, OpenClaw). The gemma4:26b model is even downloaded automatically!
• ⚡ Supercharged Terminal: Configures iTerm2 or Warp with Zsh, the Powerlevel10k theme, and essential productivity plugins (autosuggestions, syntax-highlighting, you-should-use).
• 📦 100% Declarative: All dependencies (CLI, Casks, Mac App Store, NPM, Cargo) are centralized.
• 🔄 Reproducible & Portable: Easily export and version your own Mac's settings to restore them elsewhere using the provided snapshot script.

---

🚀 1. Run the Installation (One-liner)

To execute the script on a fresh Mac, open the default terminal app and run:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/jforatier/mac-dev-setup/main/setup.sh)"

What does this script do behind the scenes?

1. Prerequisites: Installs Xcode Command Line Tools and Homebrew if missing.
2. Brewfile: Installs all CLI tools, applications (Casks), and Nerd Fonts declaratively.
3. Zsh & Themes: Installs Oh My Zsh, clones the Powerlevel10k theme and productivity plugins.
4. AI & Dev Tools: Downloads the local LLM model via Ollama and installs global NPM/Cargo packages.
5. Restoration: Automatically imports your configuration (zshrc and iTerm2 preferences) if they are present in the repository.
6. Comfort: Applies native macOS tweaks (e.g., disables the boot sound).

📸 2. Export your current Mac state (Snapshot)

Have you customized your Mac and want to back up those settings in the repository? Use the snapshot script!

Clone this repo on your machine, navigate to the folder, and run:

./snapshot_mac.sh

This will generate several backup files (ending in .local to prevent accidentally committing sensitive data):

• Brewfile.local: A list of EVERYTHING Homebrew has installed on the machine.
• zshrc.local: A copy of your current Zsh configuration.
• com.googlecode.iterm2.plist.local: Your iTerm2 preferences.
• macos_defaults.local: An export of your macOS system preferences.

To integrate them permanently into the repo:

1. Rename zshrc.local to zshrc (Don't forget to remove your private tokens/API keys!).
2. Rename the iTerm2 plist by removing the .local extension.
3. Push to GitHub: your next installation will be identical to your current Mac!

📦 3. Applications outside scripts (Manual installation)

Certain very specific applications, IDE plugins, or tools linked to personal accounts require manual intervention or are not available on Homebrew:

• Draw Things: Available on the Mac App Store.
• Claude Island / Googley Eyes: Check GitHub Releases.
• VS Code / Android Studio Extensions: Synchronize via your Microsoft/JetBrains account or install from within the IDE.

---

💡 Contribute / Get Inspired: This repo is open-source. The application choices (Warp, Obsidian, Raycast, Proxyman) reflect a specific workflow, but the Brewfile + setup.sh + snapshot architecture is the perfect starting point to fork and script your own dream setup!