dotfiles

Dotfiles (chezmoi)

Personal dotfiles managed with chezmoi.

The repository lives at git.beckesch.it:beckesch/dotfiles.git and is kept locally under ~/.local/share/chezmoi.

Quick start (new machine)

sh -c "$(curl -fsLS get.chezmoi.io)" -- -b ~/.local/bin init --apply git@git.beckesch.it:beckesch/dotfiles.git

Alternatively, use the setup.sh script in this repository, which installs chezmoi and applies the dotfiles if that hasn't happened yet.

Structure

Path	Description
dot_bashrc	Entry point for ~/.bashrc; loads all snippets from ~/.bashrc.d (interactive shells only)
dot_bashrc.d/	Modular bash config snippets, loaded in alphabetical/numeric order
dot_bashrc.d/applications/	Application-specific aliases and additions, loaded by 150-applications.sh (cd, chezmoi, containerlab, date, devpod, grep, kubernetes, ls/lsd, mkdir, ssh, starship, sudo, vi/nvim)
dot_config/	Config files under ~/.config/ (e.g. symlink to starship.toml)
empty_dot_bash_aliases	Empty ~/.bash_aliases file (placeholder)
setup.sh	Bootstrap script: installs chezmoi and applies the repository

bashrc snippet load order

The numbered files in dot_bashrc.d/ are sourced in this order:

1. 000-bash-setup-generic.sh – basic shell setup
2. 010-bash-account-specific.sh – account-/machine-specific settings
3. 100-generic-aliases.sh – general aliases
4. 150-applications.sh – loads all snippets in applications/
5. 200-networking.sh – networking aliases and helpers
6. 300-shell-safety-nets.sh – safety nets (e.g. safer aliases)

Files with a suffix not equal to .sh (e.g. mybashrc.sh-off) are intentionally not loaded.

Common workflows

# Bring a file from your home directory into the repo
chezmoi add ~/.bashrc.d/my-snippet.sh

# Update and apply the dotfiles
chezmoi update

# Show the diff between the repo and the actual home directory
chezmoi diff

# Sync on another machine
chezmoi cd   # opens the source directory; then git pull/push as usual

Debugging the bashrc

The file ~/.BASHRC_DEBUG controls the debug output of ~/.bashrc: If it exists, its content is set as the debug level and messages are printed while the snippets are loaded (see debug() in dot_bashrc).