nicknisiのdotfiles: dotコマンドで環境設定をリンクする個人リポジトリ

場所に依存しないcloneと初期条件

このリポジトリはvim、zsh、git、Homebrew、Neovimなどの設定を集めた個人用dotfilesです。README自身が作者のワークフロー向けに選んだもので、他の利用者では結果が変わり得ると説明しています。macOSでは`xcode-select --install`でCommand Line Toolsを用意し、`git clone git@github.com:nicknisi/dotfiles.git`で任意の場所へ取得します。

ホームディレクトリ直下に固定しない設計は、バックアップや複数マシンでの扱いやすさにつながります。一方、既存の`~/.zshrc`や`~/.config/nvim`をどう扱うかは自分の環境で決める必要があります。リンク前に対象ファイルを別ディレクトリへ保存し、戻せる状態を作ります。

採用前の記録ではnicknisi-dotfiles-deep-analysisのリリース、実行環境、入力、出力を固定します。画面やREADMEの印象ではなく、コマンドの終了コード、生成されたファイル、ネットワーク接続、エラー時の復帰を確認します。正常系だけでなく、設定値を欠かせた場合、権限を持たない場合、途中でプロセスを止めた場合も試します。観察結果は人が読めるメモと機械的なログの両方に残し、次の更新で同じ手順を再実行できる形にします。

導入を決める前に、nicknisi-dotfiles-deep-analysisが触れる範囲を一覧化します。読み取りだけか、ファイル変更や外部接続も行うかを分け、許可した範囲を越えた記録がないかを確認します。依存するランタイムと補助サービスの版を保存し、更新前後で差分を比較します。失敗したときに残るログの場所、利用者が元の状態へ戻す方法、削除や無効化の手順が説明できなければ、本番の対象には広げません。

この確認では、nicknisi-dotfiles-deep-analysisにない機能を推測で補いません。READMEに記載された入口から小さな入力を与え、期待する応答と実際の応答を比べます。未記載の挙動は未確認として残し、数値や互換性を一般化しません。

install.shの代わりにdotを使う

管理入口は`dot`コマンドです。`dot help`で使える操作を確認し、`dot backup`で既存のdotfilesとVim・Neovim設定を既定の`~/dotfiles-backup`などへ退避します。その後`dot link [package]`でリンクし、不要な対象は`dot unlink [package]`で外します。

ZSHがまだ設定されていない段階ではPATHにdotがないため、リポジトリルートから`bin/dot <command> <subcommand>`を使います。`DOTFILES`は設定ディレクトリの場所を指定し、リンク時にはbin、applescripts、resourcesが既定で除外されます。除外規則を理解せずに全ファイルを結び付けないことが大切です。

dotの拡張と組み込み操作

Git設定を対話的に行う`dot git setup`、macOSの既定値を変更する`dot macos defaults`、シェル変更、terminfo、Homebrewのinstallとbundle、古いシンボリックリンクの`dot legacy clean`が組み込み操作です。macOS defaultsはOS全体の挙動に影響するため、実行前後の値を記録します。

拡張はPATH上の実行可能ファイルを`dot-<command>`と命名すると追加できます。ヘルプにはファイル内の`Description:`コメントを使います。新しいコマンドを置く場合、引数、終了コード、対象パスを確認し、既存のdotと同じ名前を上書きしないようにします。

ZSHの読み込み順を読む

`config/zsh/zshrc`はEDITORをnvimにし、`~/.terminfo`のセットアップを読み込み、CODE_DIRを`~/Developer`に設定します。`$DOTFILES/zsh`から`.zsh`ファイルを再帰的に探してsourceし、存在すれば`~/.localrc`も読み込みます。`~/bin`と`$DOTFILES/bin`はPATHへ追加されます。

プラグイン管理はzfetchで、zsh-async、syntax highlighting、autosuggestions、npm scripts補完、fzf-tabなどを扱います。`~/.zshrc`や`~/.localrc`から`zfetch nicknisi/work-scripts`のように追加できます。`.localrc`はマシン固有の設定場所なので、トークンや秘密鍵をdotfilesへ混ぜない点を先に確認します。

Neovim設定はLuaが中心

READMEは、現在の設定がVim用ではなくNeovim専用へ移行し、大部分をLuaで記述していると説明します。`vim`は`nvim`の別名で、入口は`config/nvim/init.lua`です。これを`~/.config/nvim`へシンボリックリンクし、初回起動時にプラグインが導入されます。Homebrewなら`brew install neovim`、または`dot homebrew bundle`の対象になります。

リンク後に既存のNeovim設定が消えるわけではありませんが、どのファイルが実体かを`readlink`などで確認します。プラグイン取得がネットワークを使うこと、端末のフォントやOS機能に依存する設定があることを分けて記録し、最小構成で起動できるかを先に試します。

個人設定をテンプレートとして扱う

ZSH、Neovim、tmuxを同じ方針で揃えたい開発者には、ファイル構成と小さな管理コマンドが参考になります。反対に、異なるOS、シェル、エディターだけを使う場合や、環境変更を宣言的に審査したいチームにはそのままの採用は適しません。MITライセンスでも、作者の個人設定が自分の秘密を含まないとは限りません。

検証用ユーザーでcloneし、`bin/dot backup`、対象を限定した`dot link`、`dot unlink`を実行します。新しいシェルでPATH、EDITOR、`~/.localrc`の読み込み、Neovimの入口を確認し、バックアップから元へ戻します。Homebrew bundleやmacOS defaultsは最後に回し、変更一覧を人間が読める形で保存します。

リンク前後で`ls -l`と`readlink`を保存し、既存の設定がバックアップから戻ることを確認します。PATHの先頭に追加される`$DOTFILES/bin`が意図しない実行ファイルを選ばないか、`~/.localrc`に秘密が入っていないかを調べます。Neovimの初回プラグイン取得に失敗した場合でもシェルが起動できるかを、ネットワークを切った環境で試します。

編集部の結論

nicknisi/dotfilesは作者のmacOSと開発習慣を出発点にしたテンプレートで、同じツール群を使う人の初期資料になります。個人向け設定をそのまま適用せず、まずclone先、バックアップ先、リンク対象、`~/.localrc`の秘密を点検し、テストユーザーで復元手順を確認してください。

公式情報源

1. Official README
2. Project repository