A shell script to transform a macOS laptop into an incredible web and mobile development environment.
f09d06fd — Javier Sánchez 7 months ago
Updated branches and git log
58d8a787 — Javier Sánchez 7 months ago
Error on spelling check
f7549ec5 — Javier Sánchez 7 months ago
Updated README


browse log



You can also use your local clone with git send-email.

laptop 💻

🔧 A shell script to transform a macOS laptop into an incredible web and mobile development environment.

You can run this script in the same machine multiple times safely. It will install, upgrade and skips packages based on what you currently have installed.


We support:

  • macOS Mavericks (10.9)
  • macOS Yosemite (10.10)
  • macOS El Capitan (10.11)
  • macOS Sierra (10.12)
  • macOS High Sierra (10.13)
  • macOS Mojave (10.14)

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


Download the script:

curl --remote-name https://git.sr.ht/~jss/laptop/blob/master/mac

Review the script (avoid running scripts you haven't read!):

less mac

Execute the downloaded script:

sh mac 2>&1 | tee ~/laptop.log

Optionally, review the log:

less ~/laptop.log

Optionally, install jss/dotfiles.


Your last laptop script run will be saved to ~/laptop.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 issue for me. Or, attach the whole log file as an attachment.

What it sets up

macOS tools:

  • Homebrew for managing operating system libraries.

Unix tools:

  • [wget] for retrieving content from web server
  • [htop] for viewing process and managing them
  • [iftop] for monitoring network connections
  • [thefuck] for correcting your previous console command
  • [tree] for producing depth-indented listing of files
  • [unrar] for uncompressing rar files
  • [dockutil] for managing dock items
  • openssl for Transport Layer Security (TLS)
  • thesilversearcher for finding things in files
  • git for version control
  • tmux for saving project state and switching between projects
  • watchman for watching for filesystem events
  • zsh as your shell
  • [vim] as your editor

GitHub tools:

  • hub for interacting with the GitHub API

Programming languages, package managers, and configuration:

  • ASDF for managing programming language versions
  • [bundlr] for managing Ruby libraries
  • Node.js and NPM, for running apps and installing JavaScript packages
  • Ruby stable for writing general-purpose code
  • [Python3] stable for writing general-purpose code
  • [Composer] package manager for PHP
  • Yarn for managing JavaScript packages


  • Postgres for storing relational data
  • Redis for storing key-value data

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

Customize in ~/.laptop.local

Your ~/.laptop.local is run at the end of the Laptop script. Put your customizations there. For example:


brew bundle --file=- <<EOF
brew "Caskroom/cask/dockertoolbox"
brew "go"
brew "ngrok"
brew "watch"

default_docker_machine() {
  docker-machine ls | grep -Fq "default"

if ! default_docker_machine; then
  docker-machine create --driver virtualbox default

default_docker_machine_running() {
  default_docker_machine | grep -Fq "Running"

if ! default_docker_machine_running; then
  docker-machine start default

fancy_echo "Cleaning up old Homebrew formulae ..."
brew cleanup
brew cask cleanup

if [ -r "$HOME/.rcrc" ]; then
  fancy_echo "Updating dotfiles ..."

Write your customizations such that they can be run safely more than once. See the mac script for examples.

Laptop functions such as fancy_echo and gem_install_or_update can be used in your ~/.laptop.local.


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

brew install shellcheck

Thank you, contributors!


It is free software, and may be redistributed under the terms specified in the LICENSE file.