~/.*

New machine setup

On a brand new Mac, run:

curl -fsSL https://raw.githubusercontent.com/pruett/dotfiles/main/bootstrap | bash

The bootstrap script is idempotent (safe to re-run) and handles everything needed to install these dotfiles and push changes back to this repo:

1. Installs Xcode Command Line Tools (which provides git)
2. Installs Homebrew
3. Clones this repo to ~/.dotfiles over HTTPS — public, so no auth needed yet (or pulls if already present)
4. Installs all formulae and casks from the Brewfile via brew bundle (including gh and stow)
5. Authenticates with GitHub via gh auth login (SSH key generated and uploaded for you), then switches the origin remote to SSH so you can push
6. Prompts for your git identity and writes it to the gitignored git/.gitconfig.local
7. Symlinks every package with GNU Stow, backing up any conflicting existing files to <file>.pre-dotfiles

Afterwards, review MACOS.md for the manual System Preferences checklist.

Manual pieces (reference)

Everything below is done automatically by bootstrap, but documented here for one-off use.

Homebrew formulae

$ cd ~/.dotfiles && brew bundle

Dotfile symlinks with stow

# Loop over directories and run `stow` to enable respective dotfile symlinking
$ cd ~/.dotfiles && find . -not -path '*/\.*' -maxdepth 1 -mindepth 1 -type d | sed -e 's/^\.\///'| xargs -I % sh -c 'stow %'
# Remove stow link anytime with stow -D <directory>

Git

See git/README.md for SSH/GPG key setup and .gitconfig.local details.