Add docs on adding a new Mac

README.md

@@ -89,3 +89,33 @@ $ tree . -I legacy* -I link* --gitignore --dirsfirst
 ## Historical bits
 
 This repo historically contained my dot files. Historically symlinked files are still in `link/`. Most all the other old stuff is now tucked away under `legacy/` to get it out of the way until I decide what is and isn't needed.
+
+## Adding a new macOS host
+
+1. clone this repo
+2. add entry to `flake.nix`
+3. add file at `modules/home-manager/hosts/< hostname >/< username >.nix`
+4. add file at `modules/hosts/< system >/< hostname >/default.nix`
+   - run brew leaves and look for things installed from taps you don't want any more
+   - uninstall the program and the tap if not adding it to nix
+5. run macOS installer from https://determinate.systems/posts/graphical-nix-installer
+6. run `nix run nix-darwin -- check --flake ~/repos/dots`
+7. run `sudo mv /etc/shells{,.before-nix-darwin}`
+8. run `sudo mv /etc/zshenv{,.before-nix-darwin}`
+9. Note that you may also have to move or remove `~/.zshrc`
+10. Run `nix run nix-darwin -- switch --flake ~/repos/dots`
+    1. first (or several) run(s) through homebrew may well fail due to previously installed casks in `/Applications`. You may have to run brew with `--force` to fix this
+    2. you may have to run brew multiple times to fix things
+    3. in Settings > Privacy & Security > App Management you will need to allow iTerm
+    4. **Note:** ensure `firefox-profile-switcher-connector` is linked:
+11. After the nix command finally works, open a new shell and it should have all the nixified settings in it.
+12. Go into iTerm2 and use the Hack Nerd Mono font so that the prompt and other things look right. You will likely also want to adjust the size of the font.
+
+Now that that is done, setup Atuin:
+
+```bash
+atuin import auto
+read -s ak
+read -s ap
+atuin login --key $ak --password $ap --username gene
+```