Skip to content
Mind blowing mac setup
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Marvin is a shell script to set up an Mac OS laptop for development.

It can be run multiple times on the same machine safely. It installs, upgrades, or skips packages based on what is already installed on the machine.

We support:

  • macOS Mavericks (10.9)
  • macOS Yosemite (10.10)
  • macOS El Capitan (10.11)
  • macOS Sierra (10.12)

Older versions may work but aren't regularly tested. Bug reports for older versions are welcome.


In your Terminal window, copy and paste the command below, then press return.

curl --silent | sh 2>&1 | tee ~/marvin.log

The script itself is available in this repo for you to review if you want to see what it does and how it works.

Once the script is done, quit and relaunch Terminal.

It is highly recommended to run the script regularly to keep your computer up to date. Once the script has been installed, you'll be able to run it at your convenience by typing laptop and pressing return in your Terminal.

Your last marvin run will be saved to ~/marvin.log. Read through it to see if you can debug the issue yourself. If not, copy the lines where the script failed into a new GitHub Issue for us. Or, attach the whole log file as an attachment.

What it sets up

Mac OS tools:

  • Homebrew for managing operating system libraries.

Unix tools:

Programming languages:

  • Node.js for running apps and installing JavaScript packages
  • Go programming language by google
  • Ruby a dynamic programming language with a focus on simplicity and productivity
  • Clojure a dynamic, general-purpose programming language
  • Java java Runtime Environment

Package Managers:

  • Yarn for managing JavaScript packages
  • NPM node package manager
  • Rbenv for managing versions of Ruby
  • Ruby Build for installing Rubies
  • Bundler for managing Ruby libraries
  • Leiningen for automating Clojure projects
  • Glide package Management for Go


  • Consul service Discovery and Configuration Made Easy
  • Zookeeper develop and maintain an open-source servers
  • Kafka a distributed streaming platform
  • GRPC a high performance, open-source universal RPC framework
  • Image Magick to create, edit, compose, or convert bitmap images
  • Heroku Toolbelt for interacting with the Heroku API
  • Vagrant for development environments
  • Chef for automating your infrastructure


  • Postgres for storing relational data
  • Redis for storing key-value data
  • My Sql for storing relational data
  • Mongo DB for storing non relational data


  • youtube-dl download videos from YouTube
  • htop interactive system-monitor
  • tig text-mode interface for git
  • logstalgia Website Access Log Visualization
  • git-extras repo summary, repl, changelog population, author commit percentages
  • fasd command-line productivity booster


It should take less than 20 minutes to install (depends on your machine).


Edit the mac file. Document in the file. Follow shell style guidelines by using ShellCheck and Syntastic.

brew install shellcheck

Thank you, contributors!


marvin is inspired by laptop script, customized for my own needs. It is free software, and may be redistributed under the terms specified in the LICENSE file.

You can’t perform that action at this time.