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 kde apply	Pushes every manifest entry's declared value onto the live system.
dot kde diff	Reports every schema-backed setting whose live value differs from its default, tagged declared or undeclared.
dot kde help	Lists dot kde's subcommands.
dot kde save <identifier>	Reads a KDE setting's current live value and declares it in the manifest (~/.config/dot/kde-manifest).
dot kde save	Refreshes every already-declared manifest entry's value from the live system.
dot setup	Runs every machine-setup task (currently just folders).
dot setup folders	Brings the 8 standard XDG user directories (~/Desktop, ~/Documents, ...) under a fixed short-name convention (~/.desktop, ~/doc, ...).
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.

Keybindings

See keybindings.md for custom and useful default keybindings across configured tools (currently: tmux).