dotfiles

Configs are managed with GNU Stow and symlinked into $HOME.

Install

Install Xcode Command Line Tools, Homebrew, and Oh My Zsh if not already installed:

xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Then clone and run setup:

git clone https://github.com/ergusto/dotfiles.git ~/dotfiles
cd ~/dotfiles && bash ./setup.sh

setup.sh is interactive by default — it asks before installing Brewfile packages and before stowing config files.

After the first run, ~/.bin/dotfiles is on your PATH so subsequent invocations work from anywhere.

Commands

dotfiles                       # runs 'install' interactively
dotfiles install -y            # install brew + stow, no prompts
dotfiles install -b, --brew    # apply Brewfile, skip stow
dotfiles install -s, --stow    # restow all packages, skip brew

dotfiles stow update           # restow everything
dotfiles stow update nvim      # restow just nvim
dotfiles stow remove lazygit   # remove lazygit symlinks

dotfiles pull                  # git pull --recurse-submodules in $DOTFILES
dotfiles doctor                # diagnostic checks
dotfiles help [command]        # help
dotfiles --version             # dotfiles git sha

What's included

Configs: zsh, neovim, tmux, git

Tools: eza, bat, fzf, lazygit, powerlevel10k, zsh-autosuggestions, zsh-syntax-highlighting

Local overrides

These paths are for machine-specific config that shouldn't be in source control:

• ~/.zshrc-local
• ~/.bin-local/
• ~/.gitconfig-local

Node package managers

yarn/pnpm are provided by Corepack, not installed globally. After running setup.sh, enable it once:

corepack enable

This creates shims that read each project's packageManager field in package.json and run the right version per-project. Don't npm install -g yarn or brew install yarn alongside this — you'll get PATH conflicts.