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. Pass flags to skip prompts:

• -y, --yes — run everything
• -b, --brew — install Brewfile packages only
• -s, --stow — stow config files only
• -h, --help — list options

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

dotfiles          # interactive
dotfiles -y       # run everything

What's included

Configs: zsh, neovim, tmux, git

Tools: eza, bat, fzf, zoxide, 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.