html-output-generator

dotfiles

個人用のシェル設定・開発環境の設定ファイル管理リポジトリ

セットアップ

git clone <repo-url> ~/dotfiles
cd ~/dotfiles
./install.sh

管理方針

1. Symlink Only

install.shはcpではなくln -sfでシンボリックリンクを作成する。 $HOME側の変更が即座にリポジトリに反映され、Single Source of Truthを維持する。

2. 環境固有設定の分離 (Local Files)

OS固有の設定や秘密情報は.zshrc本体に記述せず、~/.local.zshrcに分離する。 .zshrc末尾で自動的にsourceされる。.local.*は.gitignoreに含まれる。

# 例: ~/.local.zshrc
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && source "$NVM_DIR/nvm.sh"

3. 設定の肥大化防止

• typeset -U path PATH でPATHの重複を防止
• [[ -f ... ]] && source ... でオプショナルなプラグインの存在チェック
• (( $+commands[cmd] )) で未インストールコマンドの設定をガード

検証環境 (Docker)

install.shの動作をクリーンなUbuntu 24.04環境で検証できる。

VSCode Dev Containers (推奨)

1. VSCodeで「Dev Containers」拡張機能をインストール
2. このリポジトリを開き、Ctrl+Shift+P → Dev Containers: Reopen in Container
3. コンテナ起動時にinstall.shが自動実行される

CLIで検証

# ビルド
docker build -t dotfiles-test .

# install.sh実行 + symlink確認
docker run --rm -v "$(pwd):/home/testuser/dotfiles" dotfiles-test \
  bash -c "cd ~/dotfiles && bash install.sh && ls -la ~/.zshrc ~/.p10k.zsh"

# zshを対話的に試す
docker run --rm -it -v "$(pwd):/home/testuser/dotfiles" dotfiles-test \
  bash -c "cd ~/dotfiles && bash install.sh && zsh"

フォント設定

エディタフォント (推奨): PlemolJP

プログラミング向け日英対応フォント。PlemolJPのReleasesからインストールし、VSCodeの設定に追加:

"editor.fontFamily": "PlemolJP Console NF"

ターミナルフォント: MesloLGS NF

Powerlevel10kの表示に必要。こちらから4つのttfファイルをダウンロードしてインストールし、VSCodeの設定に追加:

"terminal.integrated.fontFamily": "MesloLGS NF"

worktree 管理 (wt)

dotfiles/wt.zsh は git worktree を fzf ベースの wt 系コマンドで管理する zsh 関数群。.zshrc 末尾から相対パスで source される (~/.zshrc の symlink を :A で解決し同居する wt.zsh を読むため、専用 symlink は不要)。

コマンド	用途
wt	fzf で選択 → エディタ (code/zed) で開く
wt new -b <branch> <dir> [base] [-d desc]	新規作成 + 用途 (description) を記録
wt ls	用途付き一覧
wt set / wt rm	用途の編集 / worktree 削除 (fzf)
wt claude [-t [task]]	claude --bg で起動 (既定 idle、-t でタスク投入)
wt cd [<name>]	worktree へ cd

各 worktree の「何用か」は git config --worktree wt.description に保存。全コマンドの詳細は wt help、運用ルール (Claude 連携含む) は wt-manager プラグイン を参照。

テスト: zsh dotfiles/wt.test.zsh

Claude Code プラグイン

plugins/ に個人用の Claude Code プラグインを置き、.claude-plugin/marketplace.json でマーケットプレイスとして束ねる。

• plugins/ — 各プラグイン本体 (skill / agent / hook / script)。プラグインごとに README を同梱。
• .claude-plugin/marketplace.json — プラグイン一覧を登録するマーケットプレイス定義。

各プラグインの概要は plugins/README.md を参照。

ファイル一覧

ファイル	説明
dotfiles/.zshrc	Zsh設定 (oh-my-zsh + powerlevel10k)
dotfiles/.p10k.zsh	Powerlevel10kプロンプト設定
dotfiles/wt.zsh	git worktree 管理関数 (wt 系、.zshrc から source)
dotfiles/wt.test.zsh	wt.zsh のテストスイート
.wslconfig	WSL2設定 (C:\Users\<user>\.wslconfig に手動コピー)
config	SSH configテンプレート (手動コピー)
custom_keymap.txt	Google日本語入力カスタムキーマップ
extensions.json	VSCode推奨拡張機能
setup-git.sh	Git共通設定スクリプト (user設定除く)
install.sh	セットアップスクリプト