alexion 451c02f798 Build the Skeleton and a minimal neogaia Host
Stand up the walking skeleton the rest of the laptop MVI extends and
re-verifies against: the whole neogaia Host evaluates and its system
toplevel builds (nix flake check green).

- flake.nix: hand-rolled flake (no flake-parts). Base nixos-unstable, plus
  nixpkgs-unstable and nixos-25.05 for the per-package unstable/stable
  overlays, home-manager (nixpkgs followed), and chaotic-nyx (deliberately
  not following our nixpkgs, to keep its binary cache usable). checks build
  each Host toplevel.
- lib/: trimmed helper lib — the Auto-loader (recursive .nix discovery, no
  null-placeholder hack), the host-builder, and the script-from-file helper.
  Deps inherited explicitly; no with lib.my, no nixosModules output.
- system/: shared base config — the unstable/stable overlays, the user
  option (defaults to alexion, in wheel, drives system + home-manager user
  in lockstep), flakes, git, and home-manager as a NixOS module.
- modules/example.nix: Auto-loader / Enable-convention reference Module,
  inert until enabled.
- hosts/neogaia/: minimal laptop Host — placeholder filesystems, bootloader,
  and hardware profile.
- CLAUDE.md: project agent instructions with a Gotchas section (nix on the
  CachyOS dev host, the chaotic overlay/cache behaviour, the forge CLI).
2026-07-19 07:57:21 -04:00

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).

Description
My NixOS configuration(s)
Readme 2.2 MiB
Languages
Nix 50.5%
TypeScript 48%
Shell 1.2%
Lua 0.3%