Nix Darwin Configuration

macOS (aarch64-darwin) configuration using nix-darwin, home-manager, and nixvim.

構造（種別軸ツリー）

flake.nix            入力宣言＋配線＋外部公開 output のみ
keys.nix             デバイス公開鍵台帳（◆ sshKeys として外部公開）
hosts/<name>.nix     機体 = 1台1ファイル。profile を import し、機体固有差分だけ書く
profiles/<role>.nix  役割 = トピックの束（システム層＋ユーザー層の配線）
modules/<kind>/<topic>/  1 関心事 = 1 ディレクトリ。<kind> は種別バケツ：
                       base   … この機体の土台インフラ（nix 本体・macOS 既定・homebrew
                                基盤・ユーザー・SSH・作業ディレクトリ規約）。機体の前提そのもの
                       apps   … 既製品の設定値（ghostty・git・tmux・nixvim…）。
                                価値の中心は外部プロダクト、こちらは設定を書くだけ
                       custom … 自作システム（cp・chrome-anjin・network-block・
                                calendar-dashboard…）。価値の中心は自分のコード
                       domain … 生活ドメイン（latex・school/txst）。“何であるか”より
                                “なぜあるか”で分類したいもの
                     ファイル名が適用層を宣言する：
                       darwin.nix … nix-darwin（システム）層
                       home.nix   … home-manager（ユーザー）層
                       （将来 NixOS を足すなら nixos.nix を同じ部屋に足す）
                     スクリプト・アセットはトピックのディレクトリに同居させる
modules/_archive/    退役トピック。復帰は profile に import 1行

ルール：新しい関心事 = modules// に新しいディレクトリ。どの種別バケツに 置くかは modules/CLAUDE.md が判定基準を定める（ファイルを作るのは AI なので、判断基準をそこに集約している）。ユーザー設定は home.nix、システム設定は darwin.nix に書く。どのホストに入るかは profiles/ が列挙し、機体固有の差分は hosts/ に書く。

graph TD
    flake["flake.nix<br/>mkDarwinConfig"] --> ogasawara["hosts/ogasawara.nix<br/>Mac mini M4"]
    flake --> tanegashima["hosts/tanegashima.nix<br/>MacBook Air M1"]
    flake --> dejima["hosts/dejima.nix<br/>使い捨て VM<br/>(homebrew/mas 無効・MTU daemon)"]

    ogasawara --> profile["profiles/mac-workstation.nix"]
    tanegashima --> profile
    dejima --> profile

    profile --> base["modules/base/<br/>nix-core / macos-defaults / homebrew-base /<br/>host-users / remote-access / forge"]
    profile --> apps["modules/apps/<br/>shell / core-packages / git / tmux / nixvim /<br/>starship / ghostty / zed / herdr / claude /<br/>aerospace / handy / file-defaults"]
    profile --> custom["modules/custom/<br/>cp/tools / cp/dashboard / chrome-anjin /<br/>network-block / calendar-dashboard<br/>(→ desktop-switcher を連れてくる)"]
    profile --> domain["modules/domain/<br/>latex / school/txst"]

    flake -. "◆ homeModules.tmux<br/>(nixos-cp が消費)" .-> tmux["modules/apps/tmux/home.nix"]
    flake -. "◆ homeModules.forge<br/>(x1nano が消費)" .-> forge["modules/base/forge/home.nix"]
    flake -. "◆ sshKeys<br/>(x1nano が消費)" .-> keys["keys.nix"]

Loading

Build Flow

flowchart LR
    A[nix build] --> B[darwin-rebuild switch]
    B --> C[System Config]
    B --> D[Home Manager]

    C --> C1["etc files"]
    C --> C2["macOS defaults"]
    C --> C3[Homebrew bundle]
    C --> C4[Launch Daemons]

    D --> D1[Dotfiles]
    D --> D2[Shell config]
    D --> D3[Activation scripts]
    D --> D4[User packages]

Loading

Commands

操作の入口は nh。設定 flake の在処は programs.nh.darwinFlake（modules/apps/core-packages/home.nix）が NH_DARWIN_FLAKE として張るので、どのディレクトリからでも動く。ホスト名は nh が自動解決する。

nh darwin switch                    # ビルドして適用（世代 diff 付き）
nh darwin switch -n                 # dry-run
nh darwin switch -a                 # 適用前に確認を挟む
nh darwin build                     # ビルドのみ（sudo 不要）
nh darwin switch -- --show-trace    # -- 以降は nix build にそのまま渡る
nh search <pkg>                     # パッケージ / オプション検索
nh clean all -n                     # 世代の掃除（-n で確認）。定期実行は launchd に配線済み

nix flake update                    # 全 input を更新
nix flake update <input>            # 個別 input を更新
nix fmt .                           # .nix を整形（パス省略は alejandra が stdin を読んで失敗する）

別機体向けにビルドするなら nh darwin build "$NH_DARWIN_FLAKE#tanegashima"。

nh が壊れたときの逃げ道（素の nix-darwin）:

sudo darwin-rebuild switch --flake "$NH_DARWIN_FLAKE#$(hostname -s)"

2026-08-29 に Justfile（just）を撤去した。テンプレート由来で選択の記録が無く、 かつ just darwin はリポジトリ内でしか打てず「操作の前に cd」を強制していたため。