dotfiles

Configs managed with GNU Stow. Each top-level directory mirrors $HOME and gets symlinked into place.

Fresh machine setup (macOS)

# 1. Install Homebrew (https://brew.sh), then all packages
brew bundle --file=~/code/dotfiles/homebrew/.Brewfile

# 2. Symlink all configs into $HOME
make all

# 3. Apply macOS system preferences (key repeat, dock, finder, ...)
./defaults.sh

# 4. Machine-specific git identity + credential helper (not tracked in this repo)
#    gh needs an absolute path: brew runs git with a sanitized PATH
cat > ~/.gitconfig.local <<EOF
[user]
	name = Your Name
	email = you@example.com
[credential "https://github.com"]
	helper =
	helper = !$(which gh) auth git-credential
[credential "https://gist.github.com"]
	helper =
	helper = !$(which gh) auth git-credential
EOF

Maintenance

• topgrade — updates everything (brew, casks, nvim plugins, ...); config in topgrade/
• make delete — remove all symlinks
• arch_pkglist.txt — package list for the Arch Linux machine