Macos Setup

macOS Starter - Setup Skill

From Zero to Hero - AI-powered macOS development environment configuration

Quick Reference

---

Skill Capabilities

0. Network Proxy Check (前置步骤)

在开始安装前，必须确保网络可以访问 Google 和 GitHub：

check_network() {
    echo "=== Network Connectivity Check ==="
    echo ""

    # Test GitHub
    echo "Testing GitHub..."
    if curl -s --connect-timeout 5 https://github.com > /dev/null 2>&1; then
        echo "✅ GitHub: accessible"
    else
        echo "❌ GitHub: not accessible"
        NEED_PROXY=true
    fi

    # Test Google (for some Homebrew dependencies)
    echo "Testing Google..."
    if curl -s --connect-timeout 5 https://www.google.com > /dev/null 2>&1; then
        echo "✅ Google: accessible"
    else
        echo "❌ Google: not accessible"
        NEED_PROXY=true
    fi

    # Test Homebrew
    echo "Testing Homebrew..."
    if curl -s --connect-timeout 5 https://raw.githubusercontent.com > /dev/null 2>&1; then
        echo "✅ Homebrew sources: accessible"
    else
        echo "❌ Homebrew sources: not accessible"
        NEED_PROXY=true
    fi

    if [ "$NEED_PROXY" = true ]; then
        echo ""
        echo "⚠️  Network issues detected. Proxy configuration required."
        return 1
    fi

    echo ""
    echo "✅ Network OK - Ready to proceed"
    return 0
}

代理配置流程:

1. 询问用户代理信息:

questions:
  - id: proxy_needed
    question: "Do you need to configure a network proxy to access GitHub/Google?"
    options:
      - label: "Yes, I have a proxy"
        description: "Configure HTTP/HTTPS proxy"
      - label: "No, direct connection works"
        description: "Skip proxy configuration"

  - id: proxy_config
    question: "Please provide your proxy configuration:"
    condition: "proxy_needed == 'Yes'"
    inputs:
      - label: "Proxy URL"
        placeholder: "http://127.0.0.1:7890"
        example: "http://127.0.0.1:7890 or socks5://127.0.0.1:1080"

2. 设置临时环境变量:

setup_proxy() {
    local proxy_url="$1"

    if [ -n "$proxy_url" ]; then
        echo "Setting proxy: $proxy_url"
        export http_proxy="$proxy_url"
        export https_proxy="$proxy_url"
        export HTTP_PROXY="$proxy_url"
        export HTTPS_PROXY="$proxy_url"
        export ALL_PROXY="$proxy_url"

        # For Git
        git config --global http.proxy "$proxy_url"
        git config --global https.proxy "$proxy_url"

        echo "✅ Proxy configured for this session"
        echo ""
        echo "To make permanent, add to ~/.zshrc:"
        echo "  export http_proxy=\"$proxy_url\""
        echo "  export https_proxy=\"$proxy_url\""
    fi
}

3. 验证代理是否工作:

verify_proxy() {
    echo "Verifying proxy configuration..."

    if curl -s --connect-timeout 5 https://github.com > /dev/null 2>&1; then
        echo "✅ GitHub accessible via proxy"
    else
        echo "❌ GitHub still not accessible"
        return 1
    fi

    if curl -s --connect-timeout 5 https://www.google.com > /dev/null 2>&1; then
        echo "✅ Google accessible via proxy"
    else
        echo "❌ Google still not accessible"
        return 1
    fi

    echo "✅ Proxy verification passed"
    return 0
}

---

1. System Detection

Detect installed software and versions:

# Core tools detection script
detect_installed() {
    echo "=== System Detection ==="

    # Homebrew
    if command -v brew &>/dev/null; then
        echo "✅ Homebrew: $(brew --version | head -1)"
    else
        echo "❌ Homebrew: not installed"
    fi

    # Shell
    echo "✅ Shell: $SHELL"
    [ -d "$HOME/.oh-my-zsh" ] && echo "✅ Oh-My-Zsh: installed"
    command -v starship &>/dev/null && echo "✅ Starship: installed"

    # Git
    command -v git &>/dev/null && echo "✅ Git: $(git --version)"
    command -v gh &>/dev/null && echo "✅ GitHub CLI: installed"
    command -v delta &>/dev/null && echo "✅ Delta: installed"

    # Modern CLI
    command -v eza &>/dev/null && echo "✅ eza: installed"
    command -v bat &>/dev/null && echo "✅ bat: installed"
    command -v fd &>/dev/null && echo "✅ fd: installed"
    command -v rg &>/dev/null && echo "✅ ripgrep: installed"

    # Languages
    command -v fnm &>/dev/null && echo "✅ fnm: installed"
    command -v node &>/dev/null && echo "✅ Node.js: $(node --version)"
    command -v pnpm &>/dev/null && echo "✅ pnpm: installed"
    command -v uv &>/dev/null && echo "✅ uv: installed"
    command -v python3 &>/dev/null && echo "✅ Python: $(python3 --version)"
    command -v goenv &>/dev/null && echo "✅ goenv: installed"
    command -v go &>/dev/null && echo "✅ Go: $(go version)"

    # Container
    command -v docker &>/dev/null && echo "✅ Docker: installed"
    command -v kubectl &>/dev/null && echo "✅ kubectl: installed"
    command -v helm &>/dev/null && echo "✅ Helm: installed"
    command -v k9s &>/dev/null && echo "✅ k9s: installed"

    # Applications
    [ -d "/Applications/Raycast.app" ] && echo "✅ Raycast: installed"
    [ -d "/Applications/Warp.app" ] && echo "✅ Warp: installed"
    [ -d "/Applications/Visual Studio Code.app" ] && echo "✅ VS Code: installed"
    [ -d "/Applications/OrbStack.app" ] && echo "✅ OrbStack: installed"

    # Vibe Coding Tools
    echo ""
    echo "--- Vibe Coding Tools ---"
    command -v claude &>/dev/null && echo "✅ Claude Code: $(claude --version 2>/dev/null | head -1 || echo 'installed')" || echo "❌ Claude Code"
    command -v ccline &>/dev/null && echo "✅ CCometixLine: installed" || echo "❌ CCometixLine"
    [ -d "/Applications/Cursor.app" ] && echo "✅ Cursor: installed" || echo "❌ Cursor"
    command -v opencode &>/dev/null && echo "✅ OpenCode: installed" || echo "❌ OpenCode"
    [ -d "/Applications/Cherry Studio.app" ] && echo "✅ Cherry Studio: installed" || echo "❌ Cherry Studio"
    [ -d "/Applications/LM Studio.app" ] && echo "✅ LM Studio: installed" || echo "❌ LM Studio"
}

2. Interactive Q&A Flow

Use AskUserQuestion tool with structured questions:

questions:
  - id: role
    question: "What best describes your primary development role?"
    options:
      - label: "Fullstack Developer"
        description: "React/Vue + Node.js + Database"
      - label: "Frontend Developer"
        description: "React/Vue/Svelte + UI/Design tools"
      - label: "Backend Developer"
        description: "Go/Python/Java + APIs + Infrastructure"
      - label: "Data/ML Engineer"
        description: "Python + Jupyter + ML frameworks"
      - label: "DevOps/Platform"
        description: "K8s + Terraform + CI/CD"

  - id: languages
    question: "Which programming languages do you need?"
    multiSelect: true
    options:
      - label: "JavaScript/TypeScript"
        description: "fnm + Node.js LTS + pnpm"
      - label: "Python"
        description: "uv + Python 3.12"
      - label: "Go"
        description: "goenv + latest Go"
      - label: "Rust"
        description: "rustup + stable"

  - id: containers
    question: "Do you need container and Kubernetes tools?"
    options:
      - label: "Full K8s setup"
        description: "OrbStack + kubectl + helm + k9s + stern"
      - label: "Docker only"
        description: "OrbStack for containers"
      - label: "Skip"
        description: "No container tools"

  - id: vibe_coding
    question: "Which additional Vibe Coding tools do you need?"
    multiSelect: true
    note: "We assume you already have at least one AI coding tool installed to use this project."
    detection: |
      command -v claude &>/dev/null && echo "✅ Claude Code installed"
      command -v ccline &>/dev/null && echo "✅ CCometixLine installed"
      [ -d "/Applications/Cursor.app" ] && echo "✅ Cursor installed"
      command -v opencode &>/dev/null && echo "✅ OpenCode installed"
      [ -d "/Applications/Cherry Studio.app" ] && echo "✅ Cherry Studio installed"
    options:
      - label: "Claude Code"
        description: "Anthropic's official agentic CLI"
        skip_if: "command -v claude &>/dev/null"
      - label: "CCometixLine"
        description: "Claude Code statusline enhancer (Git, model, context)"
        skip_if: "command -v ccline &>/dev/null"
        requires: "Node.js"
      - label: "Cursor"
        description: "AI-first code editor"
        skip_if: "[ -d '/Applications/Cursor.app' ]"
      - label: "OpenCode"
        description: "Open-source terminal AI assistant"
        skip_if: "command -v opencode &>/dev/null"
      - label: "Cherry Studio"
        description: "AI desktop client with multi-model support"
        skip_if: "[ -d '/Applications/Cherry Studio.app' ]"

  - id: apps
    question: "Which collaboration apps?"
    multiSelect: true
    options:
      - label: "Work (CN)"
        description: "Lark + DingTalk + WeCom"
      - label: "International"
        description: "Slack + Discord + WhatsApp"
      - label: "Meetings"
        description: "Tencent Meeting + Zoom"

  - id: macos
    question: "macOS optimizations?"
    multiSelect: true
    options:
      - label: "Dock"
        description: "Hide recent apps, faster animations"
      - label: "Keyboard"
        description: "Faster repeat, disable auto-correct"
      - label: "Finder"
        description: "Show hidden files, path bar"
      - label: "Screenshots"
        description: "Save to ~/Pictures/Screenshots"

3. Plan Generation

Generate structured installation plan based on answers:

## Generated Plan for: [User Name]

### Phase 1: Prerequisites
- [ ] Xcode Command Line Tools
- [ ] Homebrew

### Phase 2: CLI Tools
| Package | Purpose | Command |
|---------|---------|---------|
| git | Version control | `brew install git` |
| gh | GitHub CLI | `brew install gh` |
| delta | Better diffs | `brew install delta` |
| starship | Modern prompt | `brew install starship` |
| eza | ls replacement | `brew install eza` |
| bat | cat replacement | `brew install bat` |
| fd | find replacement | `brew install fd` |
| ripgrep | grep replacement | `brew install ripgrep` |

### Phase 3: Language Environments
| Language | Manager | Setup Command |
|----------|---------|---------------|
| Node.js | fnm | `fnm install --lts && fnm default lts-latest` |
| Python | uv | `uv python install 3.12` |
| Go | goenv | `goenv install latest && goenv global latest` |

### Phase 4: Applications
| App | Purpose | Command |
|-----|---------|---------|
| Raycast | Launcher + window mgmt | `brew install --cask raycast` |
| Warp | Modern terminal | `brew install --cask warp` |
| OrbStack | Docker/K8s | `brew install --cask orbstack` |

### Phase 5: Vibe Coding Tools
> Note: Skip already installed tools

| Tool | Purpose | Command | Skip If |
|------|---------|---------|---------|
| Claude Code | Anthropic agentic CLI | `brew install --cask claude-code` | `command -v claude` |
| CCometixLine | Claude Code statusline | `npm install -g @cometix/ccline` | `command -v ccline` |
| Cursor | AI-first code editor | `brew install --cask cursor` | App exists |
| OpenCode | Open-source terminal AI | `brew install opencode` | `command -v opencode` |
| Cherry Studio | Multi-model AI client | `brew install --cask cherry-studio` | App exists |

### Phase 6: Fonts
| Font | Purpose |
|------|---------|
| JetBrains Mono Nerd Font | Terminal icons |
| Fira Code | Ligatures |
| Inter | UI font |

### Phase 7: Shell Configuration
- [ ] Zsh plugins (autosuggestions, syntax-highlighting)
- [ ] Starship prompt
- [ ] Modern CLI aliases

### Phase 8: macOS Defaults
- [ ] Dock optimization
- [ ] Keyboard settings
- [ ] Finder preferences

4. Execution Engine

Execute plan with progress tracking:

# Example execution with progress
execute_phase() {
    local phase=$1
    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
    echo "📦 Phase $phase"
    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
}

# Phase 1: CLI Tools
execute_phase "1: CLI Tools"
brew install git gh delta starship
brew install eza bat fd ripgrep sd dust procs bottom
brew install tree wget curl jq yq

# Phase 2: Languages
execute_phase "2: Language Environments"
brew install fnm uv goenv go
fnm install --lts
fnm default lts-latest
npm install -g pnpm

# Phase 3: Apps
execute_phase "3: Applications"
brew install --cask raycast warp orbstack

# Phase 4: Vibe Coding (with skip detection)
execute_phase "4: Vibe Coding Tools"

# Claude Code
if ! command -v claude &>/dev/null; then
    echo "📦 Installing Claude Code..."
    brew install --cask claude-code
else
    echo "⏭️  Claude Code already installed, skipping"
fi

# CCometixLine (requires Node.js)
if ! command -v ccline &>/dev/null; then
    if command -v npm &>/dev/null; then
        echo "📦 Installing CCometixLine..."
        npm install -g @cometix/ccline
        echo "💡 Configure: Add to ~/.claude/settings.json:"
        echo '   {"statusLine": {"type": "command", "command": "ccline"}}'
    else
        echo "⚠️  CCometixLine requires Node.js, install fnm/node first"
    fi
else
    echo "⏭️  CCometixLine already installed, skipping"
fi

# Cursor
if [ ! -d "/Applications/Cursor.app" ]; then
    echo "📦 Installing Cursor..."
    brew install --cask cursor
else
    echo "⏭️  Cursor already installed, skipping"
fi

# OpenCode
if ! command -v opencode &>/dev/null; then
    echo "📦 Installing OpenCode..."
    brew install opencode
else
    echo "⏭️  OpenCode already installed, skipping"
fi

# Cherry Studio
if [ ! -d "/Applications/Cherry Studio.app" ]; then
    echo "📦 Installing Cherry Studio..."
    brew install --cask cherry-studio
else
    echo "⏭️  Cherry Studio already installed, skipping"
fi

# Phase 5: Fonts
execute_phase "5: Fonts"
brew install --cask font-jetbrains-mono-nerd-font
brew install --cask font-fira-code font-inter

# Phase 6: Shell
execute_phase "6: Shell Configuration"
# Install zsh plugins...
# Configure starship...

# Phase 7: macOS
execute_phase "7: macOS Optimization"
defaults write com.apple.dock show-recents -bool false
defaults write NSGlobalDomain KeyRepeat -int 2
# ...

echo "✅ Setup complete!"

---

Presets

fullstack

name: Fullstack Developer
languages: [javascript, python]
containers: full
apps: [raycast, warp, cursor, orbstack, notion]
macos: [dock, keyboard]

frontend

name: Frontend Developer
languages: [javascript]
containers: docker
apps: [raycast, cursor, figma]
macos: [dock, keyboard]

backend

name: Backend Developer
languages: [go, python]
containers: full
cloud: [aws]
apps: [raycast, warp, cursor, orbstack]
macos: [dock, keyboard, finder]

data

name: Data/ML Engineer
languages: [python]
containers: docker
apps: [cursor, jupyter]
macos: [keyboard]

devops

name: DevOps Engineer
languages: [go, python]
containers: full
cloud: [aws, gcp]
apps: [raycast, warp, orbstack]
macos: [dock, keyboard, finder]

---

Configuration Files

This skill references:

• presets.md - Detailed preset configurations
• packages.md - Complete package registry
• ../../scripts/Brewfile - Homebrew bundle
• ../../configs/ - Configuration templates

---

Best Practices

1. Always detect first - Never reinstall what exists 2. Ask, don't assume - User preferences matter 3. Show before doing - Display plan before execution 4. Progress tracking - Use TodoWrite for visibility 5. Verify after - Confirm installations succeeded 6. Non-destructive - Never remove existing tools

---

Error Handling

# Retry failed installations
retry_install() {
    local cmd=$1
    local max_attempts=3
    local attempt=1

    while [ $attempt -le $max_attempts ]; do
        if eval "$cmd"; then
            return 0
        fi
        echo "⚠️  Attempt $attempt failed, retrying..."
        ((attempt++))
        sleep 2
    done

    echo "❌ Failed after $max_attempts attempts"
    return 1
}

---

Trigger Keywords

This skill activates on:

• /new-macos-setup
• "setup macos"
• "configure mac"
• "new mac setup"
• "dev environment"
• "install development tools"

---

Gotchas

• Brewfile on Apple Silicon: many casks have x86-only fallbacks — check architecture before bulk install, otherwise Rosetta-only apps land on M-series.
• `defaults write` changes don't always take effect immediately — some need cfprefsd flush or app restart; an apparently-applied setting may not stick.
• Xcode CLI tools install separately from Xcode.app — xcode-select switches between but doesn't install; new machines need explicit xcode-select --install.
• `com.apple.quarantine` xattr blocks unsigned binaries — xattr -d removes but Gatekeeper may re-add on next download.
• SIP (System Integrity Protection) is per-volume — disabling on recovery affects the boot drive only; external drives have their own SIP state.
• macOS Sequoia+ `sudo` no longer caches credentials by default — scripts that assumed credential cache silently re-prompt or fail in unattended runs.

Package Registry

Complete catalog of installable packages, categorized by purpose

CLI Tools

Version Control

Shell & Prompt

Modern CLI Replacements

File & Data Tools

Code Quality

---

Language Environments

Node.js

Setup:

brew install fnm
eval "$(fnm env --use-on-cd)"
fnm install --lts
fnm default lts-latest
npm install -g pnpm
pnpm setup

Python

Setup:

brew install uv
uv python install 3.12

Go

Setup:

brew install goenv go
# Add to .zshrc:
# export GOENV_ROOT="$HOME/.goenv"
# export PATH="$GOENV_ROOT/bin:$PATH"
# eval "$(goenv init -)"
# export PATH="$GOPATH/bin:$PATH"

Rust

Java

---

Container & Kubernetes

Core

Context Management

---

Cloud CLIs

---

Applications

Must Have

Development

Collaboration (CN)

Collaboration (International)

Media

System Enhancement

Quick Look Plugins

Vibe Coding (AI-Assisted Programming)

用户使用本项目时，假设已安装其中至少一个 CLI 工具。安装前会自动检测并跳过已安装的工具。

检测脚本:

detect_vibe_coding() {
    echo "=== Vibe Coding Tools ==="
    command -v claude &>/dev/null && echo "✅ Claude Code: $(claude --version 2>/dev/null || echo 'installed')" || echo "❌ Claude Code"
    command -v ccline &>/dev/null && echo "✅ CCometixLine: installed" || echo "❌ CCometixLine"
    [ -d "/Applications/Cursor.app" ] && echo "✅ Cursor: installed" || echo "❌ Cursor"
    command -v opencode &>/dev/null && echo "✅ OpenCode: installed" || echo "❌ OpenCode"
    [ -d "/Applications/Cherry Studio.app" ] && echo "✅ Cherry Studio: installed" || echo "❌ Cherry Studio"
    [ -d "/Applications/LM Studio.app" ] && echo "✅ LM Studio: installed" || echo "❌ LM Studio"
}

安装脚本 (带跳过检测):

install_vibe_coding() {
    echo "=== Installing Vibe Coding Tools ==="

    # Claude Code
    if ! command -v claude &>/dev/null; then
        echo "📦 Installing Claude Code..."
        brew install --cask claude-code
    else
        echo "⏭️  Claude Code already installed, skipping"
    fi

    # CCometixLine (requires Node.js)
    if ! command -v ccline &>/dev/null; then
        if command -v npm &>/dev/null; then
            echo "📦 Installing CCometixLine..."
            npm install -g @cometix/ccline
        else
            echo "⚠️  CCometixLine requires Node.js, install fnm/node first"
        fi
    else
        echo "⏭️  CCometixLine already installed, skipping"
    fi

    # Cursor
    if [ ! -d "/Applications/Cursor.app" ]; then
        echo "📦 Installing Cursor..."
        brew install --cask cursor
    else
        echo "⏭️  Cursor already installed, skipping"
    fi

    # OpenCode
    if ! command -v opencode &>/dev/null; then
        echo "📦 Installing OpenCode..."
        brew install opencode
    else
        echo "⏭️  OpenCode already installed, skipping"
    fi

    # Cherry Studio
    if [ ! -d "/Applications/Cherry Studio.app" ]; then
        echo "📦 Installing Cherry Studio..."
        brew install --cask cherry-studio
    else
        echo "⏭️  Cherry Studio already installed, skipping"
    fi
}

Claude Code 配置:

# 方式 1: Homebrew (推荐)
brew install --cask claude-code

# 方式 2: 原生安装脚本
curl -fsSL https://claude.ai/install.sh | bash

# 登录认证
claude login

# 启动
claude

CCometixLine 配置 (Claude Code Statusline):

# 安装 (需要 Node.js)
npm install -g @cometix/ccline

# 配置 Claude Code settings.json
# 位置: ~/.claude/settings.json
{
  "statusLine": {
    "type": "command",
    "command": "ccline",
    "padding": 0
  }
}

# 或使用 ccline 自带的 TUI 配置
ccline config

CCometixLine 功能: Git 分支状态、Claude 模型名称、上下文使用率、工作目录显示

OpenCode 配置:

# 安装
brew install opencode

# 配置 (~/.opencode/config.yaml)
default_model: anthropic/claude-sonnet-4-20250514
providers:
  anthropic:
    api_key: ${ANTHROPIC_API_KEY}

Cherry Studio 配置:

# 安装
brew install --cask cherry-studio

# 启动后在 UI 中配置 API Keys

---

Fonts

Programming Fonts

UI Fonts

---

Zsh Plugins

---

macOS Defaults

Dock

# Hide recent apps
defaults write com.apple.dock show-recents -bool false

# Faster animations
defaults write com.apple.dock autohide-delay -float 0
defaults write com.apple.dock autohide-time-modifier -float 0.3

# Set icon size
defaults write com.apple.dock tilesize -int 48

# Apply
killall Dock

Keyboard

# Faster key repeat
defaults write NSGlobalDomain KeyRepeat -int 2
defaults write NSGlobalDomain InitialKeyRepeat -int 15

# Disable auto-correct
defaults write NSGlobalDomain NSAutomaticSpellingCorrectionEnabled -bool false
defaults write NSGlobalDomain NSAutomaticCapitalizationEnabled -bool false
defaults write NSGlobalDomain NSAutomaticQuoteSubstitutionEnabled -bool false
defaults write NSGlobalDomain NSAutomaticDashSubstitutionEnabled -bool false

# Disable press-and-hold
defaults write NSGlobalDomain ApplePressAndHoldEnabled -bool false

Finder

# Show hidden files
defaults write com.apple.finder AppleShowAllFiles -bool true

# Show all extensions
defaults write NSGlobalDomain AppleShowAllExtensions -bool true

# Show path bar
defaults write com.apple.finder ShowPathbar -bool true

# Show status bar
defaults write com.apple.finder ShowStatusBar -bool true

# Apply
killall Finder

Screenshots

# Save to folder
mkdir -p ~/Pictures/Screenshots
defaults write com.apple.screencapture location ~/Pictures/Screenshots

# PNG format
defaults write com.apple.screencapture type -string "png"

# Disable shadow
defaults write com.apple.screencapture disable-shadow -bool true

# Apply
killall SystemUIServer

---

Detection Scripts

Check if package is installed

# Brew formula
brew list <package> &>/dev/null && echo "installed" || echo "not installed"

# Brew cask
brew list --cask <package> &>/dev/null && echo "installed" || echo "not installed"

# Command
command -v <cmd> &>/dev/null && echo "installed" || echo "not installed"

# App
[ -d "/Applications/<App>.app" ] && echo "installed" || echo "not installed"

Full detection script

#!/bin/bash
# detect-installed.sh

echo "=== Checking installed packages ==="

check_cmd() {
    command -v "$1" &>/dev/null && echo "✅ $1" || echo "❌ $1"
}

check_app() {
    [ -d "/Applications/$1.app" ] && echo "✅ $1" || echo "❌ $1"
}

echo "--- CLI Tools ---"
check_cmd git
check_cmd gh
check_cmd delta
check_cmd starship
check_cmd eza
check_cmd bat
check_cmd fd
check_cmd rg

echo "--- Languages ---"
check_cmd fnm
check_cmd node
check_cmd pnpm
check_cmd uv
check_cmd python3
check_cmd goenv
check_cmd go

echo "--- Container ---"
check_cmd docker
check_cmd kubectl
check_cmd helm
check_cmd k9s

echo "--- Applications ---"
check_app "Raycast"
check_app "Warp"
check_app "Cursor"
check_app "Visual Studio Code"
check_app "OrbStack"

macOS Setup Presets

Pre-configured development environment profiles for different roles

Available Presets

---

fullstack

Target: Fullstack Developer working with modern web stacks

CLI Tools

brew install git gh delta starship
brew install eza bat fd ripgrep sd dust procs bottom
brew install tree wget curl jq yq
brew install shellcheck

Languages

# Node.js
brew install fnm
fnm install --lts
fnm default lts-latest
npm install -g pnpm

# Python
brew install uv
uv python install 3.12

Container & K8s

brew install kubectl helm k9s stern
brew tap danielfoehrkn/switch
brew install danielfoehrkn/switch/switch

Applications

brew install --cask raycast
brew install --cask warp
brew install --cask cursor
brew install --cask claude-code
brew install --cask visual-studio-code
brew install --cask orbstack
brew install --cask sourcetree
brew install --cask notion

Fonts

brew install --cask font-jetbrains-mono-nerd-font
brew install --cask font-fira-code
brew install --cask font-inter

Shell Enhancement

• Oh-My-Zsh plugins: git, kubectl, zsh-autosuggestions, zsh-syntax-highlighting
• Starship prompt
• Modern CLI aliases (eza, bat)

macOS Optimization

• Dock: hide recent apps
• Keyboard: faster repeat, disable auto-correct

---

frontend

Target: Frontend Developer focused on UI/UX

CLI Tools

brew install git gh delta starship
brew install eza bat fd ripgrep
brew install tree wget curl jq

Languages

# Node.js only
brew install fnm
fnm install --lts
fnm default lts-latest
npm install -g pnpm

Container (Optional)

# Basic Docker only
brew install --cask orbstack

Applications

brew install --cask raycast
brew install --cask cursor
brew install --cask claude-code
brew install --cask visual-studio-code
brew install --cask iina
brew install --cask imageoptim

Fonts

brew install --cask font-jetbrains-mono-nerd-font
brew install --cask font-fira-code
brew install --cask font-inter
brew install --cask font-noto-sans-cjk-sc

Shell Enhancement

• Oh-My-Zsh plugins: git, zsh-autosuggestions, zsh-syntax-highlighting
• Starship prompt

macOS Optimization

• Dock: hide recent apps
• Keyboard: faster repeat

---

backend

Target: Backend Developer building APIs and services

CLI Tools

brew install git gh delta starship
brew install eza bat fd ripgrep sd dust procs bottom
brew install tree wget curl jq yq
brew install shellcheck golangci-lint

Languages

# Go
brew install goenv go
# Install latest stable Go version
LATEST_GO=$(goenv install -l | grep -E '^\s*[0-9]+\.[0-9]+\.[0-9]+$' | tail -1 | tr -d ' ')
goenv install "$LATEST_GO"
goenv global "$LATEST_GO"

# Python
brew install uv
uv python install 3.12

Container & K8s

brew install kubectl helm k9s stern
brew tap danielfoehrkn/switch
brew install danielfoehrkn/switch/switch
brew install awscli rclone

Applications

brew install --cask raycast
brew install --cask warp
brew install --cask cursor
brew install --cask claude-code
brew install --cask orbstack
brew install --cask sourcetree

Fonts

brew install --cask font-jetbrains-mono-nerd-font
brew install --cask font-fira-code

Shell Enhancement

• Oh-My-Zsh plugins: git, kubectl, zsh-autosuggestions, zsh-syntax-highlighting
• Starship prompt
• Go development aliases

macOS Optimization

• Dock: hide recent apps, faster animations
• Keyboard: faster repeat, disable auto-correct
• Finder: show hidden files, path bar

---

data

Target: Data/ML Engineer working with Python and notebooks

CLI Tools

brew install git gh delta starship
brew install eza bat fd ripgrep
brew install tree wget curl jq yq

Languages

# Python (primary)
brew install uv
uv python install 3.11
uv python install 3.12

# Node.js (for Jupyter extensions)
brew install fnm
fnm install --lts
fnm default lts-latest

Container

# Docker for ML containers
brew install --cask orbstack

Applications

brew install --cask raycast
brew install --cask cursor
brew install --cask claude-code
brew install --cask visual-studio-code

Python ML Stack (via uv)

# Create ML environment
uv venv ~/.venvs/ml
source ~/.venvs/ml/bin/activate
uv pip install jupyter pandas numpy scipy matplotlib seaborn scikit-learn

Fonts

brew install --cask font-jetbrains-mono-nerd-font
brew install --cask font-fira-code

Shell Enhancement

• Oh-My-Zsh plugins: git, zsh-autosuggestions, zsh-syntax-highlighting
• Python environment management

macOS Optimization

• Keyboard: faster repeat

---

devops

Target: DevOps/Platform Engineer managing infrastructure

CLI Tools

brew install git gh delta starship
brew install eza bat fd ripgrep sd dust procs bottom
brew install tree wget curl jq yq
brew install shellcheck

Languages

# Go (for tooling)
brew install goenv go

# Python (for automation)
brew install uv
uv python install 3.12

Container & K8s (Full)

brew install kubectl helm k9s stern
brew tap danielfoehrkn/switch
brew install danielfoehrkn/switch/switch

# Cloud CLIs
brew install awscli
# brew install google-cloud-sdk  # Optional, large
# brew install azure-cli          # Optional

brew install rclone

Infrastructure Tools

# Terraform (optional)
# brew install terraform

# Ansible (optional)
# brew install ansible

Applications

brew install --cask raycast
brew install --cask warp
brew install --cask cursor
brew install --cask claude-code
brew install --cask orbstack
brew install --cask sourcetree

Fonts

brew install --cask font-jetbrains-mono-nerd-font

Shell Enhancement

• Oh-My-Zsh plugins: git, kubectl, aws, zsh-autosuggestions, zsh-syntax-highlighting
• kubeswitch for context management
• Starship with K8s context display

macOS Optimization

• Dock: hide recent apps, faster animations
• Keyboard: faster repeat, disable auto-correct
• Finder: show hidden files, path bar

---

minimal

Target: Quick start with essential tools only

CLI Tools

brew install git gh starship
brew install eza bat fd ripgrep

Applications

brew install --cask raycast
brew install --cask warp
brew install --cask cursor
brew install --cask claude-code

Fonts

brew install --cask font-jetbrains-mono-nerd-font

Shell Enhancement

• Oh-My-Zsh plugins: git, zsh-autosuggestions, zsh-syntax-highlighting
• Starship prompt

macOS Optimization

• Dock: hide recent apps

---

Custom Preset

Create your own preset by combining options:

# Example: my-preset.yaml
name: My Custom Setup
extends: minimal  # Optional base preset

cli:
  - git
  - gh
  - delta
  - starship
  - eza
  - bat
  - fd
  - ripgrep

languages:
  nodejs: true    # fnm + pnpm
  python: true    # uv
  go: false
  rust: false

containers:
  docker: true
  kubernetes: false

apps:
  - raycast
  - warp
  - cursor

fonts:
  - font-jetbrains-mono-nerd-font

macos:
  dock:
    show_recents: false
  keyboard:
    key_repeat: 2
    initial_repeat: 15
    auto_correct: false

---

Usage

# Use a preset
/new-macos-setup --preset fullstack

# Preview preset without installing
/new-macos-setup --preset backend --dry-run

# Combine preset with modifications
/new-macos-setup --preset minimal
# Then answer additional questions to customize