macOSと研究室サーバーで共用する個人用dotfilesです。Zsh設定は機能別に分割し、プラグインをSheldon、プロンプトをStarshipで管理します。
読み込み順は暗黙のglobにせず、.config/zsh/init.zsh へ明示しています。
.zshrcはローダーだけにし、設定を機能別ファイルへ分割- Sheldonで
zsh-autosuggestionsとzsh-syntax-highlightingを管理 - Starshipで作業コンテキストと入力欄を分けた2行プロンプトを表示
- macOS、研究室サーバー、ホスト固有設定を分離
- private設定と一部の不要なアプリ生成物をGit管理から除外
- 配布対象を許可リストで限定し、既存ファイルは確認後にバックアップ
.
├── .config/
│ ├── sheldon/
│ │ └── plugins.toml # Zshプラグイン定義
│ ├── starship.toml # 2行プロンプト設定
│ ├── zsh/
│ │ ├── init.zsh # モジュールの読み込み順
│ │ ├── core.zsh # colorsなどの基本初期化
│ │ ├── env.zsh # 履歴・環境変数
│ │ ├── options.zsh # setopt / unsetopt
│ │ ├── completion.zsh # 補完とzstyle
│ │ ├── keybindings.zsh # Ctrl-P/N、Shift-Tab
│ │ ├── aliases.zsh # 一般エイリアス
│ │ ├── directories.zsh # ディレクトリスタック
│ │ ├── integrations.zsh # direnv、Kitty、ホスト設定
│ │ ├── prompt.zsh # Starship初期化
│ │ ├── plugin-settings.zsh # CJK向けプラグイン設定
│ │ ├── plugins.zsh # Sheldon初期化
│ │ ├── functions/
│ │ │ ├── notification.zsh # Slack通知
│ │ │ ├── nvidia.zsh # GPU利用状況
│ │ │ ├── pdf.zsh # PDF圧縮
│ │ │ ├── nvim.zsh # Neovimバックアップ・復元
│ │ │ └── codex.zsh # Codexアカウント切り替え
│ │ └── hosts/
│ │ ├── init.zsh # ホスト振り分け
│ │ ├── lab-server.zsh # v101〜v108共通
│ │ ├── macos.zsh # JAVA_HOME、DISPLAY
│ │ └── oroshi1.zsh # oroshi1固有
│ ├── kitty/ # Kitty設定
│ ├── lf/ # lf設定
│ └── nvim/ # Neovim設定
├── agents/ # CodexとClaude Codeで共有する設定
│ ├── AGENTS.md # 全体指示(~/.codex/AGENTS.md と ~/.claude/CLAUDE.md)
│ ├── skills/ # スキルの正本
│ └── skills.json # スキル台帳と配備先エージェント
├── .codex/
│ └── inventory.json # Codexが自分で導入したプラグイン等の記録
├── docs/
│ ├── aliases.md # エイリアス一覧
│ ├── skills.md # スキル管理ガイド
│ ├── terminal-shortcuts.md # Kitty・tmuxのショートカット
│ └── usage.md # 利用例
├── scripts/
│ ├── check-zsh.zsh # Zsh設定のスモークテスト
│ ├── deploy-skills.zsh # スキルの配備
│ ├── check-skills.zsh # スキルの検査
│ └── codex-account.py # Codexアカウント切り替えの本体
├── .zshenv # 全Zshで必要なPATH・ロケール
├── .zprofile # ログインシェル用
├── .zshrc # private設定とinit.zshの読み込み
├── .zshrc.private.example # private設定の見本
├── deploy.sh # シンボリックリンク配置
└── codex-remote-toggle.sh # Codexリモート接続切り替え
.zshenvでPATHとロケールを設定- ログインシェルでは
.zprofileを読み込み .zshrcが~/.zshrc.privateを存在する場合だけ読み込み.config/zsh/init.zshが各モジュールを明示順で読み込み- Starshipを初期化
- プラグイン事前設定を読み、Sheldonを初期化
zsh-syntax-highlighting が他のZLE設定より後になるよう、Sheldonは最後のプラグイン初期化として配置しています。
Starshipは、1行目にホスト名、ディレクトリ、Git、開発環境を表示し、2行目を入力欄として使います。 初期化処理は、環境変数やホスト設定を反映できるよう、各モジュールの後で実行します。
git clone https://github.com/sugawarahirotaka/dotfiles.git ~/dotfiles
cd ~/dotfilesStarshipとSheldonは、公式GitHubリポジトリを~/.local/srcへcloneし、Cargoでビルドします。
生成した実行ファイルは、PATHに含まれる~/.local/binから参照します。
ビルドにはGit、Rust、Cargo、Cコンパイラが必要です。 2026年8月18日時点の公式ソースは、StarshipがRust 1.95以上、SheldonがRust 1.90.0以上を要求します。 v101〜v108にはRustとCargoが入っていないため、最初に公式rustupでstableツールチェーンを導入します。
if [[ -r "$HOME/.cargo/env" ]]; then
source "$HOME/.cargo/env"
fi
if ! command -v rustup >/dev/null; then
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs |
sh -s -- -y --profile minimal --no-modify-path
source "$HOME/.cargo/env"
fi
rustup update stable
mkdir -p "$HOME/.local/src" "$HOME/.local/bin"Starshipを公式ソースからビルドします。
if [[ ! -d "$HOME/.local/src/starship/.git" ]]; then
git clone https://github.com/starship/starship.git \
"$HOME/.local/src/starship"
fi
git -C "$HOME/.local/src/starship" pull --ff-only
cargo build --release --locked \
--manifest-path "$HOME/.local/src/starship/Cargo.toml"
ln -sfn "$HOME/.local/src/starship/target/release/starship" \
"$HOME/.local/bin/starship"Sheldonも同じ配置方針でビルドします。
if [[ ! -d "$HOME/.local/src/sheldon/.git" ]]; then
git clone https://github.com/rossmacarthur/sheldon.git \
"$HOME/.local/src/sheldon"
fi
git -C "$HOME/.local/src/sheldon" pull --ff-only
cargo build --release --locked --features vendored \
--manifest-path "$HOME/.local/src/sheldon/Cargo.toml"
ln -sfn "$HOME/.local/src/sheldon/target/release/sheldon" \
"$HOME/.local/bin/sheldon"vendored機能によりOpenSSL、libgit2、curlもユーザー領域内でビルドするため、システムの開発用パッケージやsudo権限は不要です。
導入した実行ファイルを確認します。
starship --version
sheldon --versionStarshipまたはSheldonが未導入でもZshは起動します。Starshipがない場合は基本プロンプトへフォールバックし、Sheldonがない場合はSheldon管理プラグインを読み込みません。
Claude Codeを使うマシンでは、公式のネイティブインストーラで導入します。macOSとLinuxで同じ手順です。
実行ファイルは、PATHに含まれる~/.local/bin/claudeに配置され、自動で更新されます。
.npmrcでnpmのprefixを~/.localにしているため、npm版も同じ~/.local/bin/claudeに入ります。
npm版を導入済みの場合は、先にnpm uninstall -g @anthropic-ai/claude-codeで削除してください。
if ! command -v claude >/dev/null; then
curl -fsSL https://claude.ai/install.sh | bash
fi
claude --version./deploy.sh
sheldon lock既存ファイルがある場合は、バックアップして置き換えるか確認します。~/.config 全体ではなく、管理対象のサブディレクトリだけをリンクします。配置後の sheldon lock で、プラグインを初回取得します。
Codex と Claude Code は対等に扱います。~/.codex や ~/.claude があるエージェントについて、全体指示と台帳で対象にしたスキルを同じ正本からリンクします。
エージェントを後から導入した場合は、もう一度 ./deploy.sh を実行してください。シェル設定が導入済みなら ./deploy.sh --no-shell でエージェントの設定だけを配置でき、--agents codex,claude で対象を明示できます。詳しくは スキル管理ガイド を参照してください。
cp .zshrc.private.example ~/.zshrc.private
chmod 600 ~/.zshrc.privateSlack通知を使う場合だけ、SLACK_WEBHOOK_URL を設定してください。実ファイルはGit管理されません。
exec zsh構文、シンボリックリンク配置、対話シェル起動、主要なエイリアスと関数、任意ツール未導入時のフォールバックを一括で確認できます。実際のprivate設定と履歴ファイルは読み書きしません。
./scripts/check-zsh.zshdotfilesを更新します。
cd ~/dotfiles
git pull --ff-only
./deploy.sh
sheldon lock --update
exec zshStarshipとSheldon自体を更新する場合は、公式cloneをpullして再ビルドします。 実行ファイルへのシンボリックリンクはそのまま利用できます。
source "$HOME/.cargo/env"
rustup update stable
git -C "$HOME/.local/src/starship" pull --ff-only
cargo build --release --locked \
--manifest-path "$HOME/.local/src/starship/Cargo.toml"
git -C "$HOME/.local/src/sheldon" pull --ff-only
cargo build --release --locked --features vendored \
--manifest-path "$HOME/.local/src/sheldon/Cargo.toml"
starship --version
sheldon --version公式ソースはstarship/starshipとrossmacarthur/sheldonを使用します。
- v101〜v108:
hosts/lab-server.zsh - CUDA Toolkit:
/usr/local/cuda/binが存在する場合だけ.zshenvでPATHへ追加 - oroshi1:
hosts/oroshi1.zsh - macOS共通:
hosts/macos.zsh - その他の未管理ホスト: 互換用に
~/.zshrc.$HOSTがあれば読み込み