Dotfiles

My personal macOS configuration files and settings.

Configs live in this repo and are symlinked into place, so editing a file here (or in ~/.config) is the same file — changes track automatically in git.

Contents

Tool	Location	Symlinked to
Aerospace – tiling WM	.aerospace.toml, config/aerospace/	~/.aerospace.toml, ~/.config/aerospace
WezTerm – terminal	.wezterm.lua	~/.wezterm.lua
Fish – shell	config/fish/	~/.config/fish
Neovim – editor (NvChad-based)	config/nvim/	~/.config/nvim
Helix – editor	config/helix/	~/.config/helix
Kanata – keyboard remapper	config/kanata/	~/.config/kanata
mise – runtime/tool manager	config/mise/	~/.config/mise
Nix – system config	config/nix/	~/.config/nix
SketchyBar – menu bar	config/sketchybar/	~/.config/sketchybar
opencode – AI coding agent	config/opencode/	~/.config/opencode
Claude – Claude Code config	.claude/	~/.claude
Git	.gitconfig	~/.gitconfig
Zsh	.zshrc	~/.zshrc

Syncing

sync.sh adopts config files from your home directory into this repo and replaces them with symlinks. Use it when you set up a new tool and want to start tracking its config:

./sync.sh --dry-run   # preview what it would touch
./sync.sh             # adopt + symlink

Note: sync.sh is one-way (home → repo). It does not deploy the repo onto a fresh machine — for that, clone the repo and symlink manually (see below). Already-symlinked files are skipped, so it's safe to re-run.

New machine setup

git clone https://github.com/richardbray/dotfiles.git ~/dotfiles

# Root files
ln -s ~/dotfiles/.aerospace.toml ~/.aerospace.toml
ln -s ~/dotfiles/.wezterm.lua    ~/.wezterm.lua
ln -s ~/dotfiles/.gitconfig      ~/.gitconfig
ln -s ~/dotfiles/.zshrc          ~/.zshrc
ln -s ~/dotfiles/.claude         ~/.claude

# Config dirs
for d in aerospace fish nvim helix kanata mise nix sketchybar opencode; do
  ln -s ~/dotfiles/config/$d ~/.config/$d
done

Other setup scripts: mise-setup.sh (tool installs), vps_setup.sh (server provisioning).