dotfiles

macOS 向けの個人開発環境を Nix (Home Manager) を中心に宣言的に管理するリポジトリ。

アーキテクチャ

パッケージとツールの管理は用途別に 3 層に分かれている。

層	用途	設定ファイル
Nix (Home Manager)	CLI utility / バージョン固定でよいもの (jq, ripgrep, gh, tmux, starship 等)。設定ファイルの symlink と macOS defaults の適用も担う	flake.nix, nix/home.nix, nix/dotfiles/*.nix
mise	バージョン更新が頻繁、または project 単位でバージョンを切り替えたいもの (node, claude-cli, gcloud 等)	mise.toml
Homebrew	macOS GUI cask と、Nix で扱いづらい macOS 特化バイナリ (trash 等)	Brewfile

dotfiles の実体はリポジトリ直下のディレクトリ (例: .emacs.d/, tmux/, starship/) に置かれ、Home Manager の mkOutOfStoreSymlink で $HOME 配下に symlink される。この方式により、設定を直接編集してすぐ反映できる（再ビルド不要）。

前提条件

• macOS (Apple Silicon / Intel いずれも可)
• リポジトリを ~/projects/dotfiles に clone するのが想定配置。別の場所にする場合は DOTFILES_DIR 環境変数で指定する

初回セットアップ

git clone https://github.com/kuriyosh/dotfiles ~/projects/dotfiles
cd ~/projects/dotfiles
./install.sh

install.sh が自動で以下を行う：

1. Nix をインストール (determinate-systems installer を利用)

2. home-manager switch --flake . で以下を適用

   • CLI パッケージのインストール
   • dotfiles の symlink 配置
   • Homebrew のインストール (macOS only)
   • oh-my-zsh の配置 (Nix 管理、programs.zsh.oh-my-zsh)
   • macOS defaults の適用 (Dock / メニューバー等)

3. brew bundle で Brewfile の GUI アプリを入れる

4. mise install で mise 管理のツールを入れる

日常的な更新

# dotfiles 本体の更新を取り込んだあと
home-manager switch --flake ~/projects/dotfiles --impure

# Nix 依存関係の更新
nix flake update ~/projects/dotfiles

# Homebrew
brew bundle --file=~/projects/dotfiles/Brewfile

# mise
mise upgrade

ディレクトリ構成

├── flake.nix               # Nix flake エントリポイント
├── nix/
│   ├── home.nix            # 共通 Home Manager 設定 (packages, programs.git, programs.zsh)
│   └── dotfiles/
│       ├── shared.nix      # クロスプラットフォームな symlink
│       └── darwin.nix      # macOS 固有 (Homebrew, defaults, ghostty 等)
├── Brewfile                # Homebrew cask
├── mise.toml               # mise 管理ツール
├── install.sh              # bootstrap
├── .emacs.d/               # Emacs 設定
├── tmux/                   # tmux 設定
├── starship/               # starship prompt 設定
├── ghostty/, cursor/, vscode/, zed/, karabiner/, macOS/
├── .scripts/               # CLI スクリプト集 (PATH に追加される)
├── docs/
│   └── rationale.md        # ツール選定の理由
└── archives/               # 過去使っていた設定 (item2, warp, hyper)

ツール選定の理由

docs/rationale.md を参照。ターミナル / エディタ / 補完 etc. の選定経緯をまとめてある。

トラブルシューティング

home-manager switch が "file exists" で失敗する

既存の手書き dotfile (例: ~/.zshrc) が残っている場合、Home Manager は上書きを拒否する。バックアップしてから削除：

mv ~/.zshrc ~/.zshrc.bak
home-manager switch --flake . --impure

SSH で commit できない (1Password)

programs.git.signing.signer は macOS の 1Password アプリを参照する。1Password の SSH Agent 機能を有効化していること、および SSH_AUTH_SOCK が 1Password のソケットを指していることを確認。

DOTFILES_DIR が認識されない

install.sh 経由以外で home-manager switch を叩くときは --impure が必要（builtins.getEnv "DOTFILES_DIR" のため）。

アンインストール

nix run home-manager/master -- uninstall
brew bundle cleanup --file=~/projects/dotfiles/Brewfile
/nix/nix-installer uninstall  # Nix 自体を消す場合