dotfiles/.github/README.md

dotfiles

Dotfiles managed as a bare git repo checked out over $HOME, for machines running CachyOS with KDE Plasma.

Bootstrapping a new machine

mkdir -p ~/.config/fish/functions
curl -fsSL https://git.alexion.dev/alexion/dotfiles/raw/branch/main/.config/fish/functions/dot.fish \
    -o ~/.config/fish/functions/dot.fish
fish -c 'dot init'

Commands

Command	Description
dot help	Lists available commands.
dot init	Bootstraps the dotfiles repo on a new machine.
dot install <pkgs>	Installs the given pacman packages and appends them to the tracked list (~/.config/dot/packages/pacman).
dot install --restore	Reinstalls every package from the tracked list.
dot <git>	Everything else is passed to git.

See CLAUDE.md for the dot tool's internal architecture, bootstrap logic, subcommand dispatch, and test suite.