Personalized dotfiles for Unix and macOS systems, providing a tailored environment setup for efficient and comfortable usage.
xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install stow make
git clone git@github.com:boostvolt/.dotfiles.git
cd .dotfiles
make macos
make brew
make install
# ... or incremental update via:
make update
make verify
| Target | Description |
|---|---|
install |
Symlink dotfiles and setup Claude settings |
update |
Adopt local changes back into dotfiles repo |
macos |
Apply macOS system preferences |
brew |
Install Homebrew packages and enable autoupdate |
verify |
Validate symlinks and required tools are present |
For machine-specific configuration that shouldn't be tracked in git:
~/.zprofile.local- Environment variables, PATH additions~/.zshrc.local- Shell aliases, functions, local settings
These files are sourced automatically if they exist.
# Check if stow is working
stow --version
# Re-run install with verbose output
stow -v --restow --target="$HOME" --dir="$HOME/.dotfiles" .
If stow fails due to existing files:
# Backup and remove conflicting file
mv ~/.zshrc ~/.zshrc.backup
# Re-run install
make install
# Run verify to see which checks fail
make verify
# Common fixes:
# - Re-run `make install` if symlinks are missing
# - Run `brew bundle --file=extra/homebrew/Brewfile` if tools are missing