dotfiles

Personal dotfiles for macOS. Public repo — secrets live in ~/.config/secrets/ (gitignored), referenced via env vars; nothing in this repo should contain a token, key, or hostname I'd be unhappy seeing on GitHub.

Convention: files here are copied into ~, not symlinked. New machine bootstrap is a git clone plus an AI-assisted merge into ~.

Layout

~/dotfiles/
  README.md
  AGENTS.md          # how an AI agent should help me edit this repo
  zsh/               # .zshrc and friends (copied to ~)
  tmux/              # tmux.conf
  nvim/              # ~/.config/nvim/ contents
  git/               # gitconfig, gitignore_global
  install.sh         # mechanical: copy files into ~, idempotent

(Sub-directories appear as I actually write the configs. Not pre-creating empty dirs.)

What's NOT in here

• ~/.config/secrets/ — tokens (e.g. claude.env). Mode 600.
• Anything machine-specific that changes per laptop (those go in a non-versioned ~/.config/local/ if I ever need them).