alexion
4bffa8dede
In-file comments should describe only what the file currently is, not task numbers, external tooling, or past/future states. - hosts/neogaia: drop the "replaced by disko" / "arrive later" framing; describe the filesystems and hardware profile as the placeholder values they are. - lib: drop the "no null-placeholder traversal hack" comparison to a prior implementation. - system: drop "no impure environment lookup" from the user.name description and the sops/post-boot roadmap from the user comment.
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 vpn up |
Brings the UDM-PRO-Laptop WireGuard connection up via NetworkManager. |
dot vpn down |
Brings the UDM-PRO-Laptop WireGuard connection down. |
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).