🛠️ macOS Development Setup (v3.3.0)

Automated setup for a modern macOS development environment on Apple Silicon.

Quick Start

# Clone and run
git clone https://github.com/mojwang/macbook-dev-setup.git
cd macbook-dev-setup

# Preview what will be installed
./setup.sh preview

# Run setup
./setup.sh

# Reload shell after completion
source ~/.zshrc

What's Included

Essential development tools for:

• Languages: Node.js (NVM), Python (pyenv), Ruby, Go, Rust
• Containers: Docker, Kubernetes tools
• Databases: PostgreSQL, MySQL, Redis
• Cloud: AWS, Azure, GCP CLIs
• Modern CLI: Enhanced terminal tools (bat, eza, fzf, ripgrep)
• AI Tools: Claude Desktop with MCP servers

See full tool list →

Setup Commands

./setup.sh               # Standard installation
./setup.sh preview       # Preview changes without installing
./setup.sh minimal       # Install essential tools only
./setup.sh advanced      # Interactive menu for all options
./setup.sh fix           # Run diagnostics and fix common issues
./setup.sh warp          # Configure Warp terminal optimizations
./setup.sh backup        # View backups
./setup.sh backup clean  # Clean old backups
./setup.sh backup migrate # Migrate legacy backups to new structure
./setup.sh help          # Show help message

Power User Options

# Use environment variables for advanced control
SETUP_VERBOSE=1 ./setup.sh        # Verbose output
SETUP_JOBS=8 ./setup.sh           # Custom parallel jobs (default: CPU count)
SETUP_LOG=setup.log ./setup.sh    # Log output to file
SETUP_NO_WARP=true ./setup.sh     # Skip Warp terminal detection

Common Tasks

./scripts/health-check.sh    # Verify installation
./scripts/update.sh          # Update everything
./scripts/pre-push-check.sh  # Run before pushing

Documentation

• Getting Started - Detailed setup guide
• Commands Reference - All available commands
• Tools & Features - Complete tool list
• Configuration - Customization options
• MCP Servers - Claude AI integrations
• Git Workflow - Worktrees & branch management
• Maintenance - Updates, health checks, rollbacks
• Architecture - Technical details
• Troubleshooting - Common issues

Requirements

• macOS Sequoia 15.5+ (optimized for Apple Silicon)
• Administrator access
• Internet connection
• Xcode Command Line Tools (install with: xcode-select --install)

Contributing

See Contributing Guide | Commit Guide | Branch Protection

License

MIT - See LICENSE file