Seamless command-line experience across macOS, Linux, and Windows Subsystem for Linux

About

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.

Installation

1. (macOS only) Sign into Mac App Store to install macOS apps listed in Brewfile may be installed.

2. Clone repository and configure the machine:

git clone https://github.com/mattrohr/dotfiles.git && cd dotfiles && ./install.sh

3. Refer to manual.md for manual installation steps.

Notes

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.

Acknowledgements

• 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