new-mac-setup

Generate idempotent shell scripts to bootstrap Apple Silicon Macs for development.

154|9|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/swyxio/skills --skill new-mac-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-mac-setup
Source: https://github.com/swyxio/skills/tree/main/new-mac-setup
Command: npx skills add https://github.com/swyxio/skills --skill new-mac-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires homebrew, fnm, uv, curl, git, gh, npm, ollama, mas, peon-ping, and includes scripts (resource) components.

What problem does it solve?

Setting up a new Apple Silicon Mac for fullstack and AI development is a time-consuming, error-prone manual process that requires installing dozens of tools, configuring shell and terminal settings, applying macOS preferences, and setting up dotfiles — often taking hours and leading to inconsistent environments across machines.

Core Features & Use Cases

  • Idempotent Automated Setup: Generates 7 standalone, re-runnable shell scripts that handle the entire bootstrap process from Xcode CLI tools to macOS system preferences, with built-in checks to skip already-installed tools.
  • Opinionated, Tested Configuration: Includes pre-configured settings for Ghostty + cmux terminal, Oh-My-ZSH with powerlevel10k, Node via fnm, Python via uv, Docker via Colima, and AI tooling including Claude Code, Ollama, and Antigravity CLI, all based on real-world Apple Silicon Mac setup experience.
  • Use Case: Ideal for new hires setting up their first work Mac, developers rebuilding a machine after a wipe or migration, or teams standardizing their development environment across multiple Macs to eliminate "it works on my machine" issues.

Quick Start

Use the new-mac-setup skill to fully bootstrap your new Apple Silicon Mac for fullstack and AI development, automating the installation of all required dev tools, terminal and shell configuration, and optimized macOS system settings.

Frequently Asked Questions about new-mac-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate new Mac setup for fullstack and AI development?

Automate new Mac setup by generating idempotent shell scripts that install Homebrew packages, configure Oh-My-ZSH, set up Node via fnm, Python via uv, Docker via Colima, and AI tooling including Claude Code and Ollama, eliminating manual configuration work.

What's the best way to configure a macOS developer environment across multiple team Macs?

Configuring a macOS developer environment across multiple team Macs is best handled by running standardized, re-runnable shell scripts that apply identical system preferences, terminal settings, and dev tools, eliminating inconsistent environments and 'it works on my machine' issues.

Can I use this macOS setup to install Homebrew, fnm, and uv together?

Yes, this macOS setup installs Homebrew, fnm, and uv together, along with git, gh, npm, curl, and ollama, generating standalone scripts that configure your entire fullstack and AI development stack with built-in checks to skip already-installed tools.

Does this new Mac bootstrap support Apple Silicon Macs specifically?

This new Mac bootstrap specifically supports Apple Silicon Macs, applying tested configurations for Ghostty + cmux terminal, Oh-My-ZSH with powerlevel10k, Docker via Colima, and optimized macOS system preferences via defaults commands based on real-world Apple Silicon setup experience.

What is included in an automated macOS developer environment setup for AI tooling?

An automated macOS developer environment setup for AI tooling includes installing Claude Code, Ollama, and Antigravity CLI, alongside standard fullstack tools like Node via fnm, Python via uv, Docker via Colima, and Ghostty + cmux terminal configuration.

Why do I need idempotent shell scripts for a post-wipe Mac rebuild?

Idempotent shell scripts are needed for a post-wipe Mac rebuild because they can be safely re-run without causing errors, automatically skipping already-installed tools and ensuring your developer environment reaches a consistent, fully configured state every time.