dotfiles

This repo is intended to let me bootstrap a new machine quickly:

1. Install apps and CLI tools (Homebrew Bundle on macOS; optional on Linux).
2. Symlink dotfiles into place (GNU Stow).

Quick Start (macOS)

./install.sh

Or (Finder): double-click bootstrap.command.

That will:

• Install everything in Brewfile (brew bundle --no-upgrade by default)
• Ensure oh-my-zsh is installed in ~/.oh-my-zsh
• Link dotfiles into $HOME using stow (packages: zsh/, git/, nvim/, neofetch/, zed/)

If you already have dotfiles and want to move them aside automatically:

./bin/dotfiles link --backup

Run a non-destructive sanity check:

./bin/dotfiles doctor

Makefile Shortcuts

If you prefer make:

make bootstrap
make link-backup
make brew-sync
make lint
make test

Debian/Ubuntu (Best Effort)

./bin/dotfiles apt install
./bin/dotfiles link

If you install Linuxbrew separately, you can also run:

./bin/dotfiles brew install

Updating The Brewfile

To merge what is currently installed via brew into Brewfile (without deleting existing entries):

./bin/dotfiles brew sync

To record currently-installed versions (audit trail):

./bin/dotfiles brew snapshot

To uninstall anything not listed in the Brewfile (destructive):

./bin/dotfiles brew prune

Repo Layout

• Brewfile: apps + CLI tools (source of truth for macOS installs)
• zsh/, git/, nvim/, neofetch/, zed/: GNU Stow packages that mirror the target paths under $HOME

Machine-Local Overrides (Not Committed)

• ~/.zshrc.local
• ~/.zsh_aliases.local
• ~/.config/nvim/lua/local.lua