https://github.com/26zl/macos-dev-setup
Automated MacOS setup for development
https://github.com/26zl/macos-dev-setup
automation cybersecurity development dotfiles dotfiles-macos macos script shell zsh
Last synced: 4 months ago
JSON representation
Automated MacOS setup for development
- Host: GitHub
- URL: https://github.com/26zl/macos-dev-setup
- Owner: 26zl
- License: mit
- Created: 2025-10-08T13:45:34.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-02-10T19:47:23.000Z (4 months ago)
- Last Synced: 2026-02-10T21:23:40.127Z (4 months ago)
- Topics: automation, cybersecurity, development, dotfiles, dotfiles-macos, macos, script, shell, zsh
- Language: Shell
- Homepage:
- Size: 2.19 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# macOS Development Environment Setup
[](https://github.com/26zl/MacOS-Dev-Setup/actions)
[](https://github.com/26zl/MacOS-Dev-Setup/actions)
[](https://github.com/26zl/MacOS-Dev-Setup/actions)
[](https://opensource.org/licenses/MIT)
**One-command setup** for a complete macOS development environment with automated tool management.
## Quick Start
**One-liner install:**
```bash
curl -fsSL https://raw.githubusercontent.com/26zl/MacOS-Dev-Setup/main/bootstrap.sh | zsh
```
**Or clone manually:**
```bash
git clone https://github.com/26zl/MacOS-Dev-Setup.git
cd MacOS-Dev-Setup
./install.sh # Installs shell setup and system package managers
./dev-tools.sh # Installs language tools (optional)
source ~/.zshrc
```
**Daily usage:**
```bash
update # Update all tools
verify # Check status
versions # Show versions
```
## Features
- **One Command Updates**: Update Homebrew, Python, Node.js, Ruby, Rust, Go, Swift, .NET, and more
- **Beautiful Terminal**: Powerlevel10k, syntax highlighting, autosuggestions
- **Safe & Smart**: Protects system files, graceful error handling
- **Multi-Language**: Python (pyenv), Node.js (nvm), Ruby (chruby), Rust (rustup), Swift (swiftly), Go, Java, .NET
- **CI/CD Safe**: Non-interactive mode support
## Installation
### Basic Setup
```bash
./install.sh
source ~/.zshrc
```
**Installs**: Xcode CLT, Git, Homebrew, Oh My Zsh, Powerlevel10k, ZSH plugins, maintain-system script
**Optional**: MacPorts, mas, Nix, FZF (interactive prompts)
### Development Tools
```bash
./dev-tools.sh # Interactive installation
./dev-tools.sh check # Dry-run
./dev-tools.sh test # Test detection
```
**Installs**: Conda, pipx, pyenv, nvm, chruby, rustup, swiftly, Go, Java, .NET
## Usage
### Commands
- `update` - Update all tools, package managers, and language runtimes
- `verify` - Check status of all installed tools
- `versions` - Display versions of all tools
### What Gets Updated
**Package Managers**: Homebrew, MacPorts, Nix, mas, Conda, pipx
**Languages**: Python (pyenv), Node.js (nvm), Ruby (chruby), Rust (rustup), Swift (swiftly), Go, Java, .NET
**Global Packages**: npm, Cargo, Go tools, Python packages, RubyGems
**Note**: Only global/system packages are updated. Project files (`package.json`, `go.mod`, etc.) are never modified.
### Configuration
Environment variables:
- `MAINTAIN_SYSTEM_CLEAN_PYENV=0` - Disable Python cleanup
- `MAINTAIN_SYSTEM_CLEAN_NVM=0` - Disable Node.js cleanup
- `MAINTAIN_SYSTEM_CLEAN_CHRUBY=0` - Disable Ruby cleanup
- `MAINTAIN_SYSTEM_PYENV_KEEP="3.11.8,3.10.14"` - Keep specific Python versions
- `MAINTAIN_SYSTEM_NVM_KEEP="v18.19.1"` - Keep specific Node.js versions
- `MAINTAIN_SYSTEM_CHRUBY_KEEP="ruby-3.4.6"` - Keep specific Ruby versions
- `MAINTAIN_SYSTEM_SWIFT_SNAPSHOTS=1` - Enable Swift snapshots
## Supported Tools
**Package Managers**: Homebrew, MacPorts, Nix, mas, Conda, pipx
**Languages**: Python (pyenv), Node.js (nvm), Ruby (chruby), Rust (rustup), Swift (swiftly), Go, Java, .NET
**Databases**: MySQL, MongoDB, PostgreSQL (detection only)
**Other**: Docker, C/C++ (via Xcode CLT)
## Terminal
Pre-configured with Oh My Zsh, Powerlevel10k, syntax highlighting, autosuggestions, and FZF.
### Ghostty Setup (Optional)
```bash
brew install --cask ghostty
mkdir -p ~/.config/ghostty
cp "Ghostty config.txt" ~/.config/ghostty/config
cp background/terminal-background.png ~/.config/ghostty/terminal-background.png
```
## FAQ
**Will this modify my project files?**
No! Only global/system packages are updated. Project files are never modified.
**Is it safe for CI/CD?**
Yes! Set `NONINTERACTIVE=1` or `CI=1` for automated runs.
**Does it work on Intel and Apple Silicon?**
Yes! Automatically detects architecture.
**What if tools are missing?**
The `update` command gracefully skips missing tools and shows installation instructions.
## Compatibility
| Requirement | Details |
|---|---|
| **macOS** | macOS 13 Ventura or later (may work on older versions) |
| **Architecture** | Apple Silicon (M1/M2/M3/M4) and Intel x86_64 |
| **Shell** | Zsh (default on macOS since Catalina) |
| **Disk space** | ~15-30GB free (Xcode CLT + Homebrew + dev tools) |
| **Network** | Required for all installations (downloads from GitHub, Homebrew, etc.) |
| **Permissions** | Some optional tools (MacPorts, Nix) require sudo |
## Security
- Input validation and sanitization
- Selective error handling
- Safe directory navigation
- HTTPS-only downloads with TLS verification
**Note**: Scripts download external content. Review scripts before running for maximum security.
## Contributing
1. Run `./quick-test.sh` to verify syntax
2. Ensure ShellCheck passes
3. Test on both Intel and Apple Silicon Macs
**CI/CD**: ShellCheck, Gitleaks, Trivy, syntax checks, comprehensive macOS tests.
## License
MIT License - see [LICENSE](LICENSE) file for details.
---
If this project helped you, please consider giving it a star!
[](https://github.com/26zl/MacOS-Dev-Setup/stargazers)
[](https://github.com/26zl/MacOS-Dev-Setup/fork)