Seamless command-line experience across macOS, Linux, and Windows Subsystem for Linux
Dotfiles are shell script files that backup, restore, and sync system settings. Named with a leading period (e.g. .zshrc), they remain hidden on Unix-like operating systems.
-
(macOS only) Sign into Mac App Store to install macOS apps listed in
Brewfilemay be installed. -
Clone repository and configure the machine:
git clone https://github.com/mattrohr/dotfiles.git && cd dotfiles && ./install.sh- Refer to
manual.mdfor manual installation steps.
If .secret exists, it will be sourced in .zshrc with other files. Use it for commands, files, and directories you don’t want in a public repository, like server credentials, blacklisted websites, and cryptographic keys.
Scripts are idempotent: they can be rerun safely. Useful for when settings reset, like after macOS updates reset Touch ID sudo authentication.
If you're new to macOS, read tips and tricks.
- Mathias Bynens for his dotfiles repository structure
- Kevin Suttle for his macOS defaults catalog, which provides sensible documentation for
.macos - Anish Athalye for his prompt theme