dotfiles

由来: Upstream GNU Stowと導入対象ツール / Plugin 各plugin managerの導入物 / Configuration common/・mac/・linux/内の設定 / Custom install.sh・scripts/・各種拡張（区分）

macOS / Linux の開発環境を GNU Stow で再現する設定リポジトリ。

対応環境

• macOS
• Ubuntu / Debian、Alpine Linux
• sudo を利用できない Linux
• 開発用 Docker container

構成

common/     共通設定（Neovim、Zsh、tmux、Git、AI CLI など）
mac/        macOS 固有設定
linux/      Linux 固有設定
config/     Brew、apt、pixi、mise、npm のパッケージ宣言
scripts/    セットアップとユーザー向けコマンド
docs/       導入・運用・仕様ドキュメント
install.sh  共通インストーラー

全ドキュメントは docs/INDEX.md から参照できる。外部ツール、プラグイン、ローカル実装の境界は構成要素の由来にまとめている。

前提条件

• Git
• curl
• macOSでは Command Line Tools（xcode-select --install）
• no-sudo Linuxでは bash 4以上と unzip

1Password CLI、Homebrew、各種CLIは可能な範囲で install.sh が導入する。

インストール

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

初回実行時に1Passwordへ未サインインでも、secret依存処理をスキップしてStowまで完了する。実行後に表示される案内どおり、サインインして同じコマンドを再実行する。

op signin
./install.sh

sudoを利用できないLinuxでは、両方の実行に --no-sudo を付ける。

./install.sh --no-sudo
~/.local/bin/op signin
./install.sh --no-sudo

containerなどsecretを使わない環境では --skip-1p を指定できる。詳しい分岐と実行内容はインストールガイド、no-sudo固有事項はNo-Sudo Install Modeを参照。

運用コマンド

dots apply             # package宣言とdotfile linkを反映
dots update            # git pull --ff-only後、mise.lockを更新して必要ならcommitし、依存を反映
dots check             # CIと同じrepository check
dots doctor            # toolとStow linkを診断

mise run apply|update|check|doctor も同じ入口を呼ぶ。設定ファイルだけの変更はStow済みのシンボリックリンクへ即時反映される。

mise toolはmacOS / Linux x86_64 / arm64のversion・URL・checksumをcommon/mise/.config/mise/mise.lockへ固定する。npm CLIもconfig/packages.npm.txtでversionを固定し、週次workflowが3日以上経過したreleaseだけを更新PRにする。

主な設定

分野	入口
Neovim	docs/tools/neovim/overview.md
tmux	docs/tools/tmux.md
Zsh	docs/tools/zsh-startup-optimization.md
Git	docs/configuration/git-config.md
CLIツール	docs/configuration/modern-cli-tools.md
Pi / Claude Codeなど	docs/INDEX.md#aiエージェント
リモート接続（rcon）	docs/infrastructure/rcon.md

ローカル専用ファイル

次のファイルはリポジトリで管理しない。

• ~/.zshrc.local
• ~/.gitconfig.local
• ~/.ssh/config.d/*
• ~/.config/rcon/targets
• 認証情報、履歴、キャッシュ

ライセンス

MIT