Skip to content
sugawarahirotakaPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

dotfiles

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リモート接続切り替え

Zshの読み込み順

  1. .zshenv でPATHとロケールを設定
  2. ログインシェルでは .zprofile を読み込み
  3. .zshrc が ~/.zshrc.private を存在する場合だけ読み込み
  4. .config/zsh/init.zsh が各モジュールを明示順で読み込み
  5. Starshipを初期化
  6. プラグイン事前設定を読み、Sheldonを初期化

zsh-syntax-highlighting が他のZLE設定より後になるよう、Sheldonは最後のプラグイン初期化として配置しています。

Starshipは、1行目にホスト名、ディレクトリ、Git、開発環境を表示し、2行目を入力欄として使います。 初期化処理は、環境変数やホスト設定を反映できるよう、各モジュールの後で実行します。

セットアップ

1. リポジトリを取得

git clone https://github.com/sugawarahirotaka/dotfiles.git ~/dotfiles
cd ~/dotfiles

2. StarshipとSheldonを導入

Starshipと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 --version

StarshipまたはSheldonが未導入でもZshは起動します。Starshipがない場合は基本プロンプトへフォールバックし、Sheldonがない場合はSheldon管理プラグインを読み込みません。

3. Claude Codeを導入

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

4. dotfilesを配置

./deploy.sh
sheldon lock

既存ファイルがある場合は、バックアップして置き換えるか確認します。~/.config 全体ではなく、管理対象のサブディレクトリだけをリンクします。配置後の sheldon lock で、プラグインを初回取得します。

Codex と Claude Code は対等に扱います。~/.codex や ~/.claude があるエージェントについて、全体指示と台帳で対象にしたスキルを同じ正本からリンクします。 エージェントを後から導入した場合は、もう一度 ./deploy.sh を実行してください。シェル設定が導入済みなら ./deploy.sh --no-shell でエージェントの設定だけを配置でき、--agents codex,claude で対象を明示できます。詳しくは スキル管理ガイド を参照してください。

5. private設定を作成

cp .zshrc.private.example ~/.zshrc.private
chmod 600 ~/.zshrc.private

Slack通知を使う場合だけ、SLACK_WEBHOOK_URL を設定してください。実ファイルはGit管理されません。

6. 新しいZshを開始

exec zsh

検証

構文、シンボリックリンク配置、対話シェル起動、主要なエイリアスと関数、任意ツール未導入時のフォールバックを一括で確認できます。実際のprivate設定と履歴ファイルは読み書きしません。

./scripts/check-zsh.zsh

更新

dotfilesを更新します。

cd ~/dotfiles
git pull --ff-only
./deploy.sh
sheldon lock --update
exec zsh

Starshipと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 があれば読み込み

詳細

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages