mcpField
S
shell-env

shell-env

github.com/kriscardその他1547 回インストール1 日前に更新
リポジトリ

shell-env について

shell-env は、GNU Stow で管理するシェルおよびターミナル設定リポジトリを保守するスキルです。指定されたソースツリーからの編集を案内し、Zsh、Ghostty、Tmux、Starship、yabai、Git の確認と再読み込み手順を示します。

主な機能

  1. 01Stow のソースを優先する編集手順
  2. 02ツール別の構文・動作チェック
  3. 03設定の再読み込みガイド
  4. 04リンク確認と同期手順

活用シーン

  1. 01リポジトリのソースからターミナル設定を編集
  2. 02Zsh の起動設定変更を検証
  3. 03シンボリックリンク変更の確認と適用
  4. 04変更したターミナルコンポーネントの再読み込み

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/kriscard/skills --skill shell-env

インストール後、Claude Code で/shell-envを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
git-config.md
modern-cli-tools.md
terminal-config.md

詳細

シェルとターミナル環境

このリポジトリでは、~/.dotfiles/home/ にある GNU Stow パッケージを1つ使用しています。設定を変更する場合は、このディレクトリ内のソースを編集してください。レイアウトがこのドキュメントと異なる場合は、~/.dotfiles/README.md、dotfiles --help、現在のシンボリックリンクのリンク先を正とします。

現在のソースの場所

ツールソース
Zsh~/.dotfiles/home/.zshrc と ~/.dotfiles/home/zsh/zsh.d/
Ghostty~/.dotfiles/home/.config/ghostty/config
Tmux~/.dotfiles/home/.config/tmux/tmux.conf
Starship~/.dotfiles/home/.config/starship.toml
yabai~/.dotfiles/home/.config/yabai/yabairc
Git~/.dotfiles/home/.gitconfig*

構成を変更する前に、readlink または ls -ld でリンク先を確認してください。

Stow を優先する編集手順

  1. ~/.dotfiles/home/ 内のソースを見つけて確認します。
  2. ホームディレクトリ内のリンクではなく、ソースを編集します。
  3. 変更したツールについて、範囲を絞った構文または動作チェックを実行します。
  4. リンク構造を変更した場合は、dotfiles sync --dry-run を実行し、提案された操作をすべて確認してから、dotfiles sync を実行します。
  5. 影響を受けるコンポーネントのうち、最小範囲のものを再読み込みします。
  6. ソースパス、検証結果、再読み込みの結果、または残っている手動作業を報告します。

ソースが意図したホームディレクトリのパスを管理し、構文と動作のチェックが通り、稼働中の設定が再読み込みされているか、残りの手動作業が明示されていれば完了です。

リンクの作業手順

ツールごとに個別の Stow パッケージを作るのではなく、リポジトリの CLI を使用してください。

cd ~/.dotfiles
dotfiles sync --dry-run
dotfiles sync

競合が発生した場合や動作が不明確な場合は、リンクを変更する前に dotfiles --help、README.md、home/ ツリーを確認してください。現在のレイアウトでは home パッケージを1つ使用しているため、リンクの操作にはツールごとの Stow コマンドではなく、dotfiles sync を使用します。

ツールの検証

Zsh

編集したモジュールを検証してから、起動経路全体を確認します。

zsh -n ~/.dotfiles/home/.zshrc
zsh -n ~/.dotfiles/home/zsh/zsh.d/<module>.zsh
zsh -i -c exit

モジュールの数値順を維持し、コードを別のファイルに移動する前に依存関係を確認してください。

Ghostty

編集する前に、現在の設定で受け付けられる構文、テーマ、フォントを確認してください。インストール済みの Ghostty のバージョンを使って再読み込みするか、アプリを再起動し、変更した設定を画面上または利用可能な診断機能で確認してください。

Tmux と sesh
tmux source-file ~/.config/tmux/tmux.conf
sesh list

再読み込み時のエラーを記録してください。設定済みの TPM ディレクトリを維持し、プラグインマネージャーが一度だけ初期化されるようにしてください。

Starship
starship explain
starship timings

影響を受けるモジュールを現在のプロンプトで確認してください。

yabai
yabai --restart-service

サービスの再起動だけで十分とせず、再起動後に変更したルールまたは動作を確認してください。

参考資料

優先度参照するタイミング参考資料
高エイリアスを追加する場合、または最新の CLI の代替手段を評価する場合references/modern-cli-tools.md
高Ghostty、tmux/sesh、Starship、yabai、またはツール間のテーマ設定を変更する場合references/terminal-config.md
高Git の ID、署名、条件付きインクルード、ページャー、またはエイリアスを変更する場合references/git-config.md

クイックチェック

readlink ~/.zshrc
readlink ~/.config/ghostty/config
cd ~/.dotfiles && dotfiles sync --dry-run
find ~ -maxdepth 3 -type l ! -e 2>/dev/null

コメント

Markdown 対応