nix-darwin + home-manager による個人開発環境設定です。
- flake.nix — エントリポイント（nixpkgs / nix-darwin / home-manager）
- darwin/ — macOS システム設定と Homebrew（taps / brews / casks）の宣言的管理
- home/ — home-manager。
config/配下の設定ファイルを symlink（mkOutOfStoreSymlink） - config/ — nvim / tmux / zsh / starship 等の実体。編集は即反映（rebuild 不要）
- local/ — git 管理外。work の git identity・社内 URL 等のマシンローカル設定
flowchart TB
subgraph repo["dotfiles リポジトリ"]
flake["flake.nix<br/>(エントリポイント)"]
darwin["darwin/<br/>macOS 設定"]
brew["darwin/homebrew.nix<br/>cask・重量級 brew"]
home["home/default.nix<br/>CLI パッケージ (nixpkgs)"]
links["home/links.nix<br/>symlink 定義"]
config["config/<br/>設定の実体"]
local["local/<br/>(git 管理外)<br/>work 設定・secret"]
end
flake --> darwin
flake --> home
darwin --> brew
home --> links
links --> config
links --> local
switch(["make switch<br/>= darwin-rebuild switch"]) ==> flake
darwin -.->|OS 設定適用| macos["macOS<br/>(TouchID sudo 等)"]
brew -.->|cleanup=uninstall| brewpkg["Homebrew<br/>(GUI アプリ)"]
home -.->|インストール| nixpkg["~/.nix-profile<br/>(CLI ツール)"]
config -.->|"mkOutOfStoreSymlink で直接 link（編集は即反映・rebuild 不要）"| hometarget["~/.config, ~/.zshrc …"]
local -.->|"直接 link"| hometarget
classDef ext fill:#e8f4ff,stroke:#4a90d9,color:#1a1a1a;
classDef cmd fill:#fff3cd,stroke:#d9a441,color:#1a1a1a;
class macos,brewpkg,nixpkg,hometarget ext;
class switch cmd;
.nixを変更したときはmake switchで反映（パッケージ・OS 設定・symlink 構成が更新される）config/配下の設定ファイルは repo を直接 symlink しているため、編集するだけで即反映（rebuild 不要）
設計の詳細と移行計画は docs/design.md を参照。
Xcode CLT / Homebrew / Nix / clone / 初回適用までを bootstrap スクリプトが冪等に実行します。
curl -fsSL https://raw.githubusercontent.com/yuucu/dotfiles/main/scripts/bootstrap.sh | bash途中 Xcode CLT のインストールと sudo のパスワード入力で対話が入ります。何度実行しても既存分はスキップされます（冪等）。処理内容は scripts/bootstrap.sh を参照。
# 1. Xcode CLT と Homebrew（brew 管理のパッケージ用）
xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. Nix のインストール（Determinate Systems installer）
curl -fsSL https://install.determinate.systems/nix | sh -s -- install --no-confirm
# 3. clone
mkdir -p ~/ghq/github.com/yuucu
git clone https://github.com/yuucu/dotfiles ~/ghq/github.com/yuucu/dotfiles
cd ~/ghq/github.com/yuucu/dotfiles
# 4. 適用（初回。dotfiles の symlink と brew パッケージ一式が入る）
# username は実ログインユーザーに追従するため（flake.nix が DOTFILES_USER を参照）、
# getEnv を使う都合で --impure を付ける。config 名も <ユーザー名>-mac になる。
sudo DOTFILES_USER="$(whoami)" nix run nix-darwin/master -- switch --impure --flake ".#$(whoami)-mac"
# 5. 以降の適用
make switchflake.nix の
usernameはDOTFILES_USER（未設定なら実ログインユーザー）に追従します。以前必要だった「flake.nix の username を手で書き換える」手順は不要です。
local/の作成（git 管理外。ないと~/.gitconfig等の symlink が空振りする）local/gitconfig… 本体。identity と[include] path = ~/.gitconfig.localなどlocal/gitconfig-personal… 個人用 identity（includeIfで~/ghq/github.com/yuucu/配下に適用）local/gitconfig.local/local/zshrc.local… work 固有の URL 書き換えや関数
- シェルを開き直す … zinit・プラグインは初回起動時に自動インストールされる
mise install/gh auth loginなどツール個別のログイン
| コマンド | 説明 |
|---|---|
make switch |
flake の変更をシステムに適用 |
make check |
適用せずに評価チェック（shell / lua / nix の lint 込み） |
make update |
flake inputs・Neovim プラグイン・mise の更新（check が通ってから switch） |
make fmt |
nix ファイルの整形（nix fmt） |
make gc |
30 日より古い世代の削除と Nix store の GC |
make ci-check |
CI と同じチェック（flake check + build dry-run + 全履歴 gitleaks） |
make hook-install |
lefthook の git hook を有効化 |
make status |
環境の状態確認 |
lint ツール（shellcheck / stylua / nixfmt / statix / deadnix）は flake の checks に組み込まれており、CI・ローカルとも flake.lock で固定された同一バージョンを使います。単発で使いたい場合は nix develop で devShell に入れます。
git hook（lefthook）は CI との重複を避け、軽いチェックだけを担当します。pre-commit は staged ファイルの lint（shellcheck / stylua）と gitleaks（staged のみ）、pre-push は nix flake check（lint 群の最終確認）を実行します。重い build dry-run と全履歴 gitleaks は GitHub Actions に任せ、ローカルで完全再現したいときは make ci-check を使います。
config/ 配下（nvim 設定など）の編集は symlink 経由で即反映されるため、make switch は不要です。ファイルの追加・削除・link 先の変更をしたときだけ make switch を実行します。
MIT License