Make this Mac yours.
Your apps, your tools, your preferences. One thoughtful setup.
Built for macOS · Apple Silicon & Intel
Everything you’ve chosen
A small handoff to your Mac.
The public website makes your plan. The local companion installs it and shows real progress.
-
1
Keep your downloaded plan
Save
mac-setup-plan.jsonsomewhere you can find it. -
2
Open the companion from Terminal
Open Terminal (⌘ Space, then “Terminal”), paste this command and press Return. Apple’s Command Line Tools may need a first-time installation.
curl -fsSL https://raw.githubusercontent.com/pedrobritx/mac-setup/main/bootstrap.sh | bash -s -- --webYou can read the launcher first. Already have a clone? Run
./web.sh. -
3
Import, review, install
The companion opens in your browser. Choose “Import plan”, select your JSON file, review your choices and confirm. Keep Terminal open for password prompts.
This website cannot inspect or change your Mac. Live progress appears after you launch the local companion.
Your Homebrew command.
It installs only the apps and tools you selected. Preferences, setup steps and connections stay as they are.
-
1
Have Homebrew ready
If Terminal says “brew: command not found”, install Homebrew first and follow the “Next steps” it prints.
Get Homebrew at brew.sh -
2
Install your apps and tools
Open Terminal (⌘ Space, then “Terminal”), paste this command and press Return.
This selection has no Homebrew apps or tools. Go back to add some, or use the guided setup.
-
3
Add your App Store apps
Optional. Sign in to the App Store first, then run this after the command above. Free apps are added to your Apple Account; paid apps need an existing purchase. Terminal may ask for your Mac password.
Not in these commands
These choices need the guided setup, or your own steps:
Installation progress
Installer output
Commands and reports stay on this Mac.