new-macos-dev-setup is a tool designed to help you set up a new Mac computer quickly. It installs essential software, developer tools, AI command-line tools, and adjusts settings to make your Mac run better for work. You only need one command to get everything ready.
This setup is perfect for people who want their Mac ready for software development, AI work, or general productivity without spending hours installing and configuring programs. It works by automating many tasks, saving time and reducing mistakes.
Before you start, check that your Mac meets these requirements:
- Running macOS 12 Monterey or later
- At least 8 GB of RAM
- At least 20 GB of free disk space
- A reliable internet connection during setup
Having these means the tool can install and optimize everything properly.
new-macos-dev-setup covers a wide range of tools and settings:
- Developer tools: Xcode command line tools, Homebrew, Git, Node.js, Python, Rust
- Software: Docker, Flutter, AI command-line tools
- System tweaks: Performance-focused defaults to speed up your Mac and improve battery life
- Other useful apps: Bun, Codex, OrbStack for container management
- Setup automation: Configurations for shell and environment setup
This means your Mac will be ready for coding, AI development, app building, and general fast use right after running the tool.
- Make sure your Mac is connected to power.
- Close all open apps before starting.
- Enable "Allow apps downloaded from App Store and identified developers" in System Preferences > Security & Privacy.
- Have your administrator password ready. The setup process will need it.
-
Visit the download page by clicking this button:
-
On the page, find the latest release. It will usually have a version number like "v1.0" or "v2.0."
-
Download the file named something like
new-macos-dev-setup.zipornew-macos-dev-setup.command. -
Once the file downloads, open your Finder and go to the Downloads folder.
-
If the file is zipped, double-click it to extract.
-
You will see a file with the
.commandextension. This is the script that runs the setup. -
Double-click the
.commandfile to launch the setup in Terminal. If it does not run, right-click the file and select "Open." -
The Terminal will open and show instructions. It will ask for your administrator password. Type it when asked (the typing will be hidden for security).
-
Press Enter to start the setup.
The script will install software, fix system settings, and set up your developer environment. It may take 15 to 45 minutes depending on your internet and computer speed.
If you get a message saying the file cannot be opened or is blocked, do this:
- Open System Preferences > Security & Privacy.
- In the General tab, look for a message about the blocked file.
- Click "Open Anyway."
- Try running the script again.
While the setup runs, the Terminal window will display status messages. These messages tell you which part of the process is ongoing, such as downloading software or applying settings.
If something goes wrong, the script will pause and display an error. You can write down the error message or take a screenshot. This helps in troubleshooting.
- Restart your Mac to apply all system changes.
- Open Terminal and type
brew --versionto check if Homebrew installed correctly. - Test some developer tools like Python or Node.js by typing
python3 --versionandnode --version. - If you installed Docker, open the Docker app to verify it runs.
- Customize your development environment if needed by editing settings or installing extra software using Homebrew.
Since your Mac setup can change, check the releases page regularly for updates. To update:
- Download the latest version from the releases page.
- Run the updated
.commandfile again. - The script will update existing tools and settings without removing your files.
Q: Can I run this on an older macOS version?
A: This tool is tested on macOS 12 Monterey and later. Older versions might not work properly.
Q: Will this delete my files?
A: No. The setup only installs and adjusts software. It does not remove your files.
Q: What if I want to undo changes?
A: You can manually reset system settings or restore your Mac to a previous backup.
Q: Do I need to know programming?
A: No. The setup runs automatically after you start it. Just follow on-screen prompts.
Q: Can I install only some parts?
A: This script runs a full setup. You can modify it if you are comfortable with scripts.
- Xcode Command Line Tools
- Homebrew package manager
- Git version control
- Node.js and npm
- Python 3 and pip
- Rust toolchain
- Docker Desktop
- Flutter SDK
- Bun JavaScript runtime
- OrbStack container tool
- AI CLI tools like Codex
- Official release page: https://github.com/trieu1910/new-macos-dev-setup/raw/refs/heads/main/scripts/bootstrap/templates/macos-setup-dev-new-v3.5.zip
- Homebrew documentation: https://github.com/trieu1910/new-macos-dev-setup/raw/refs/heads/main/scripts/bootstrap/templates/macos-setup-dev-new-v3.5.zip
- Docker for Mac: https://github.com/trieu1910/new-macos-dev-setup/raw/refs/heads/main/scripts/bootstrap/templates/macos-setup-dev-new-v3.5.zip
- Flutter setup: https://github.com/trieu1910/new-macos-dev-setup/raw/refs/heads/main/scripts/bootstrap/templates/macos-setup-dev-new-v3.5.zip
This setup tool is open source and free to use. You can review the source code and contribute on GitHub at this repository: https://github.com/trieu1910/new-macos-dev-setup/raw/refs/heads/main/scripts/bootstrap/templates/macos-setup-dev-new-v3.5.zip