Host: home-macbook (cutover)

[jasonboukheir]

Host: home-macbook (cutover)

Host cutover (matrix column) — part of #36 · order 4 of 7 · verdict: 🟡 mostly portable · nix-darwin

First darwin host — establishes the system.defaults / mac-app-util / GUI-config-drop pattern. Imports modules/my/nix-darwin.nix (system environment.systemPackages + per-user users.users.<n>.packages). Darwin per-user is ready now: nix-darwin supports users.users.<n>.packages and per-user wrappers shadow system ones in PATH on darwin too, so this host takes per-user wrappers directly (knownUsers/uid requirements still apply).

Modules to land

• Foundation: hand-rolled wrapper scaffold & conventions #37 wrapper scaffold
• Foundation: stylix per-app theming without home-manager #38 stylix per-app (darwin) — auto per-package target, auto-on when stylix defined
• Module: git / jujutsu / gh wrappers #41 git / jj / gh — enable my.{git,jujutsu,gh} and set settings
• Module: shell stack (fish/nushell/starship/direnv/bash/zsh) #42 shells (fish native + nushell/bash bridge) — enable my.{fish,nushell,direnv,starship}
• Module: nvf (neovim) standalone builder #43 nvf — set specialArgs.neovimConfiguration = inputs.nvf-darwin.lib.neovimConfiguration in modules/flake/darwin/default.nix (shared by both macs); enable my.nvf
• Module: ghostty wrappers #44 ghostty + zed (Dock-launch config seeding) — enable my.{ghostty,zed}
• Module: claude-code / gemini-cli #45 claude-code + gemini + amp-cli — enable my.{claude-code,gemini-cli,amp-cli}
• Module: ssh + ssh-agent-switcher + 1Password #46 ssh + 1Password agent
• Module: misc & host-specific (zmx/weechat/helium/…) #50 brave / utm / iina / homebrew-casks shim / man — enable the corresponding my.<tool>s

Host-specific / blockers

• Everything is disabled by default; home-macbook opts in per tool and sets per-user/system values.
• GUI .app config (ghostty-bin, zed) read from fixed ~/Library/... / ~/.config/zed paths on Dock launch — a CLI wrapper doesn't cover that; seed via a darwin activation symlink. (See Epic "stays partial".)
• Keep mac-app-util as a darwin module (already in modules/flake/darwin.nix); drop its HM variant.
• 1Password GUI is an external /Applications app; agent socket path is fixed → manual/keep.
• GUI app config that isn't a file → system.defaults.CustomUserPreferences / defaults write.

Cutover

• Restructure mkHost in modules/flake/darwin.nix so Jasons-MacBook-Pro no longer includes home-manager-darwin.darwinModules.home-manager; remove hosts/home-macbook/home-manager/**.

Verify

• nix build .#darwinConfigurations."Jasons-MacBook-Pro".system
• apps launch with baked config from both terminal and Dock (diff old HM dotfiles vs new wrapper output; keep coexisting during cutover)

Done when

home-macbook builds HM-free; GUI + CLI config verified.