_____ ____ _______ ______ _____ _ ______ _____
| __ \ / __ \__ __| ____|_ _| | | ____|/ ____|
| | | | | | | | | | |__ | | | | | |__ | (___
| | | | | | | | | | __| | | | | | __| \___ \
| |__| | |__| | | | | | _| |_| |____| |____ ____) |
|_____/ \____/ |_| |_| |_____|______|______|_____/
> macOS development environment setup with modular dotfiles
aws > amazon is taking over the world
bin > custom bin scripts
brew > homebrew all the things
config > for the noble apps using .config
dictionary > extend the macos dictionary
git > global git config and aliases
mackup > mackup config
mcp > manage mcp.json config(s)
mise > mise for maintaining language versions
obs > various tools for obs
ssh > ssh config
tmux > tmux config
vim > vim configs
zprezto > framework for Zsh
zsh > shell configuration 🔥🔥One-liner remote install:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/jasonraimondi/dotfiles/HEAD/install.sh)"Then run setup:
cd dotfiles && bash setup.shWhat this does: Sets up a complete macOS dev environment with shell configs, applications, and tools managed through GNU Stow symlinks.
Configure git user (required):
# Edit the template file with your info
vim git/dot-git-userGenerate SSH key:
ssh-keygen -t ed25519
cat ~/.ssh/id_ed25519.pub | pbcopy # copies to clipboardAdd to GitHub
Customize shell:
# Private customizations (not tracked)
vim ~/.zsh/99-custom.zshGNU Stow creates symlinks from ~/dotfiles/ to your home directory. The --dotfiles flag converts dot-example files to .example dotfiles.
ZSH automatically sources all *.zsh files from ~/.zsh/ using the Prezto framework for enhanced functionality.
Homebrew installs software through categorized Brewfiles: Requirefile (essentials), Brewfile (CLI tools), Caskfile (GUI apps), Fontfile, and Macfile (Mac App Store).
mise manages programming language versions defined in .tool-versions for consistent development environments.
Update packages:
# Install/update individual brew categories
brew bundle --file brew/Requirefile # essentials first
brew bundle --file brew/Brewfile # CLI tools
brew bundle --file brew/Caskfile # GUI apps
brew bundle --file brew/CaskfileQuicklook # quicklook extensions
brew bundle --file brew/Fontfile # fonts
brew bundle --file brew/Macfile # Mac App Store apps
# Update language versions
mise install --yes && mise reshimRe-apply symlinks:
bash setup-stow.shUpdate submodules:
git submodule update --init --recursiveReferences: