Your computer,
set up automatically.
Mousehat configures a new machine exactly the way you like it — apps, settings, dock, and everything else — in a single command.
Mousehat configures a new machine exactly the way you like it — apps, settings, dock, and everything else — in a single command.
One command installs everything — no technical setup required.
Click to copy · macOS · Linux · WSL
Setting up a new computer is tedious. You install the same apps, tweak the same settings, and arrange the same dock — every single time.
Mousehat remembers everything. Your apps, your preferences, your layout. Point it at a new machine and it takes care of the rest, automatically.
No manual steps. No forgotten settings. No "I can't remember what I had installed." Just your computer, exactly the way you like it.
Mousehat handles the full setup — not just apps, but the details that make your computer feel like yours.
Install all your apps from a simple list. Homebrew, the Mac App Store, apt, snap — Mousehat handles them all without you lifting a finger.
Apply your preferred macOS or Linux settings automatically — from Dock behaviour and hot corners to accessibility and security preferences.
Your dock, exactly as you like it. Configure which apps appear, in what order, and Mousehat will set it up that way every time.
Run apps inside Docker containers with one-click launchers on your desktop or in your menu. Great for tools you want isolated from your system.
Already set up? Run it again after adding something new. Mousehat skips what's already in place and only applies what's changed.
Everything is driven by simple YAML config files. Add your own custom setup steps alongside the built-in ones without touching any code.
No deep technical knowledge required. If you can open a terminal, you can run Mousehat.
Open Terminal and paste this command. It installs Mousehat and all its requirements automatically.
curl -fsSL https://mousehat.dev/install.sh | bash
The installer asks where your settings are. Choose to use the built-in sample to get started quickly, or point it at your own private git repo.
Mousehat installs your apps, sets your preferences, and arranges your dock. Grab a coffee — it handles everything.
Add a new app to your settings file and run Mousehat again. It skips what's already in place and only applies what changed.
cd ~/mousehat && ./mh-apply.sh
A settings directory is just a folder of plain-text YAML files — simple lists describing the apps and preferences you want on your machine. It looks like this:
macos-brew.yml ← Homebrew apps macos-configure-os-settings.yml ← dock & system settings linux-packages.yml ← Linux/WSL packages customroles.yml ← extra automation
Keep it in a private git repo and you'll have a permanent backup you can use on any new machine. Not sure where to start? Browse the sample settings →
Whether you're on a Mac, a Linux desktop, or Windows via WSL — Mousehat has you covered.
Full support for Intel and Apple Silicon Macs. Manages Homebrew, Mac App Store apps, Dock layout, and system preferences.
Supports Debian, Ubuntu, and Arch Linux. Manages apt packages, snap apps, GNOME settings, and desktop environment configuration.
Run Mousehat inside Windows Subsystem for Linux. Get your Linux environment set up exactly the way you like it, on Windows.