Install on a new machine. Pass the config name from the table below: the hostname is set by the config itself, so it is not yet known on the first run.

nix --extra-experimental-features 'nix-command flakes' run github:kannapoix/dotfiles -- <config name>

Apply. Each host config sets networking.hostName, so darwin-rebuild and home-manager pick the config for the current machine by hostname; no #name is needed after the first run.

Run the one that matches where the change is. nix-darwin installs home-manager but does not activate the home config, so the two are not interchangeable.

A change under hosts/ (system settings, Homebrew):

sudo darwin-rebuild switch --flake ~/dotfiles

A change under home/ (user packages, dotfiles, Claude Code's CLAUDE.md and skills):

home-manager switch --flake ~/dotfiles

Hosts

hostname / config name	nix-darwin	home-manager
kBook-Pro	hosts/mbp-2021	home/mbp-2021 (uk@kBook-Pro)
work-mac	hosts/work-mac	home/work-mac (uk@work-mac)