whatisgithub

What is laptop?

thoughtbot/laptop — explained in plain English

Analysis updated 2026-06-24

8,553ShellAudience · developerComplexity · 1/5LicenseSetup · easy

In one sentence

A shell script that sets up a Mac for web and mobile development in under 15 minutes, installing Homebrew, Git, Node.js, Ruby, Postgres, Redis, and more, safe to re-run after updates.

Mindmap

mindmap
  root((laptop))
    What It Does
      Mac dev setup
      Auto installs tools
      Under 15 minutes
    Tools Installed
      Homebrew and Git
      Node and Ruby
      Postgres and Redis
    Customization
      laptop.local file
      Add extra packages
      Run extra scripts
    Compatibility
      Intel and Apple Silicon
      Last 4 macOS versions
      Safe to re-run
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Bootstrap a new Mac or freshly wiped machine with all essential web development tools in a single script run.

USE CASE 2

Re-run after a macOS update to upgrade outdated tools without worrying about conflicts or duplicates.

USE CASE 3

Add a ~/.laptop.local file to extend the default setup with your own tools, dotfiles, and custom configuration.

What is it built with?

ShellHomebrewmacOS

How does it compare?

thoughtbot/laptopprasanthrangan/hyprdotsorbstack/orbstack
Stars8,5538,5218,587
LanguageShellShellShell
Setup difficultyeasyhardeasy
Complexity1/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min
Open source under a permissive license, free to use, modify, and share for any purpose.

So what is it?

Laptop is a shell script that sets up a Mac computer for web and mobile development. You download the script, review it, run it, and it installs a collection of developer tools automatically. The whole process takes under 15 minutes on a typical machine. The script is designed to be run more than once safely. If a tool is already installed and up to date, the script skips it. If a newer version is available, it upgrades it. This means you can re-run it after a macOS update or on a freshly wiped machine without worrying about conflicts. What gets installed covers the common foundations of web development on a Mac: Homebrew (a package manager for installing other tools), Git for version control, a handful of command-line utilities, Node.js and Ruby runtimes with their package managers, Postgres and Redis databases, and tools for interacting with services like Heroku and GitHub. It also installs Rosetta 2, which lets older tools run on newer Apple Silicon processors. If you need to add anything beyond what the script installs by default, you can put extra instructions in a file called ~/.laptop.local. That file runs at the end of the main script and can add packages, create configurations, or run any other setup steps you need. The README includes an example showing how to add extra tools via Homebrew. The project is maintained by thoughtbot, a software consultancy. It supports the four most recent major versions of macOS and works on both Intel and Apple Silicon hardware. The script is open source under a permissive license.

Copy-paste prompts

Prompt 1
I just ran thoughtbot/laptop on my new Mac. Show me how to write a ~/.laptop.local file that also installs VS Code, Docker Desktop, and sets up my SSH keys.
Prompt 2
The laptop script installed an older Ruby version. How do I switch to a specific Ruby version on a Mac set up with the thoughtbot laptop script?
Prompt 3
I'm onboarding a new developer and want to automate their Mac setup. Adapt the thoughtbot/laptop script pattern to also configure git globals and install my team's preferred CLI tools via a .laptop.local file.

Frequently asked questions

What is laptop?

A shell script that sets up a Mac for web and mobile development in under 15 minutes, installing Homebrew, Git, Node.js, Ruby, Postgres, Redis, and more, safe to re-run after updates.

What language is laptop written in?

Mainly Shell. The stack also includes Shell, Homebrew, macOS.

What license does laptop use?

Open source under a permissive license, free to use, modify, and share for any purpose.

How hard is laptop to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is laptop for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.