dotfiles

Add a new config file or topic to this dotfiles repo so bootstrap symlinks it into $HOME, handling special targets and private/template variants. Use when asked to track a new dotfile, rc file, or app config in the dotfiles.

Add a cross-distro package to this dotfiles repo — map it in script/packages.conf for apt/pacman/dnf, add the macOS brew equivalent, and wire it into install-base or install-desktop. Use when asked to make the dotfiles install a new tool/package.

Add a new interactive shell function to this dotfiles repo (system/programs.zsh), following the repo's guard/IFSUDO/bilingual/cross-platform conventions, and keep the README in sync. Use when asked to add a helper, command, or shell function to the dotfiles.

Verify changes to this dotfiles repo without mutating $HOME — syntax-check edited zsh/bash files, run shellcheck if present, dry-run bootstrap, and smoke-load functions in a clean shell. Use after editing any shell module, script, or function here, before committing.