My Dotfiles Managemen using Chezmoi

Chezmoi を利用して作成した dotfiles。 動作確認は今のところ Ubuntu のみ。 Bash と Zsh に対応。

installation

Ubuntu

前提:

• cURL, Git がインストール済み

# 一時的に使うchezmoiをインストールする
sh -c "$(curl -fsLS get.chezmoi.io)"
# このリポジトリを所定ディレクトリにクローンし適用
${HOME}/bin/chezmoi init https://github.com/ebal5/dotfiles-chezmoi.git
${HOME}/bin/chezmoi apply
# 初期スクリプトを起動する
${HOME}/once_setup_ubuntu.sh
# https -> sshへオリジンを変更する（SSHキーによるpush/pullを可能にする）
# cdの戻りを考えなくていいようにサブシェル
(
  ${HOME}/bin/chezmoi cd
  git remote set-url origin git@github.com:ebal5/dotfiles-chezmoi.git
)
# 初期に使用したchezmoiを削除しmiseでインストールしたものを利用するようにする
rm ~/bin/chezmoi

install 後の作業

~/.config/local/ にマシン固有の設定ファイルを作成する。

Git ユーザー設定

~/.config/local/git_user_config に Git 用のユーザー設定を記述する。

例: 基本のユーザー設定と、特定ディレクトリ配下の Git リポジトリのみで利用する設定を読み込む

[user]
  name = USERNAME_OF_GITHUB
  email = EMAIL_ADDRESS@GITHUB

[includeIf "gitdir:~/Projects/SOME_COMPANY/"]
  path = PATH_OF_ONLY_SOMECOMPANY_CONFIG_FILE

シェル用ローカル設定

マシン固有のシェル設定を以下のファイルに記述する。ファイルが存在する場合のみ自動的に読み込まれる。

ファイル	タイミング	用途
~/.config/local/profile.local	ログイン時（1回）	環境変数、PATH追加など
~/.config/local/shellrc.local	インタラクティブシェル起動時	エイリアス、関数など

例: GPU環境向けの設定

# ~/.config/local/profile.local
export CUDA_HOME="/usr/local/cuda"
export PATH="$CUDA_HOME/bin:$PATH"
export LD_LIBRARY_PATH="$CUDA_HOME/lib64:${LD_LIBRARY_PATH:-}"

ssh鍵によるコミット署名設定

以下のコマンドでssh鍵によるGitコミットの署名を設定可能。 リポジトリごとに署名鍵を変更する場合は最後のコマンドをローカルとして各リポジトリで行うなどの工夫が必要。

git config gpg.format ssh
git config commit.gpgsign true
git config user.signingkey "$(ssh-add -L | grep 'SOME_CONDITION')"

ユーザーレベルGitignore設定

このdotfilesは ~/.config/git/ignore にユーザーレベルのgitignoreファイルを設定します。 このファイルは全てのGitリポジトリで自動的に適用され、以下のような開発環境固有のファイルを無視します：

• Claude Code: ローカル設定ファイル、キャッシュ、ログ
• 開発ツール: Mise/RTX設定、IDE固有ファイル、エディタ一時ファイル
• OS固有ファイル: macOS、Windows、Linux生成ファイル
• セキュリティ: 環境変数ファイル、SSHキー、APIトークン
• ビルド・キャッシュ: 各言語のビルド成果物、パッケージマネージャーキャッシュ
• コンテナ: Docker Compose overrides、Vagrantファイル

プロジェクト固有のファイルを無視する場合は、各プロジェクトの .gitignore ファイルを使用してください。

設定内容

• パッケージ管理ツールを利用したセットアップ
• Bash / Zsh 対応（共通エイリアス、個別設定ファイル）
• SSH キーの共有（Bitwarden 利用）
  • https://github.com/joaojacome/bitwarden-ssh-agent の6237a3604を利用
  • 使用する場合、利用者各個人で内容確認推奨
• Nix による開発ツール管理
  • CLI ツール（Starship、git-delta、lsd、mcfly など）をflake.nixで統合管理
  • システム環境の再現性を向上
  • パッケージ追加後の更新: nix profile upgrade . または nix profile install .
• Starship
• mise (alt asdf)（プロジェクト単位のバージョン管理用）
• uv（Python パッケージ管理）
• Git config
  • diff として delta を利用
  • 便利エイリアスを登録（よく使うコマンドの短縮など）
• 作成したスクリプトの共有

Zsh 固有の設定

• 履歴設定（重複除去、共有履歴など）
• オートコンプリーション
• 各種ツールとの統合（mise、starship、mcfly など）

chezmoi's doc

Starship の主な設定内容

• プロンプトは 2 行に分け、1 行目を情報表示に利用する
• 実行結果末尾に改行がない場合付与する
• 設定したモジュールに関して、カッコ（"[" "]"）で囲い表示
• AWS の日本リージョンに関しては短縮表記を利用
• 実行に 10 秒以上かかったコマンドはかかった秒数を表示
• カレントディレクトリは直近 2 つのディレクトリのみ表示
• Git:ブランチを表示（mainおよびmasterの場合は表示しない）
• Git:ワークツリーの追加行数・削除行数を表示
• Git:リポジトリの状態を表示（!: 差分あり、など）
• 2 行目プロンプトに時刻を表示

主なシェル用エイリアス（Bash / Zsh 共通）

エイリアス	展開	備考
l	ls	ディレクトリ配下の一覧
ll	ls -alF	リスト表示
sl	ls	タイポ対策
cd..	cd ..	タイポ対策
..	cd ..
...	cd ../../
.2	cd ../../
.3	cd ../../../
cg	cd $(git rev-parse --show-toplevel)	Git リポジトリのトップに cd する
gs	git status	タイポ対策
tf	terraform
g	git
d	docker
dc	docker compose
ddu	docker compose down && docker compose up -d

主な Git コマンドのエイリアス

エイリアス	展開	備考
a	add	ワークツリーのファイルをインデックスに登録する
au	add -u	インデックスに登録されているファイルに差分があれば登録する
br	branch	ブランチ
c	commit	コミット
cam	commit --amend -m	メッセージを記載して amend
caum	commit --amend -am	更新ファイルを追加しメッセージを記載して amend
cmm	commit -m	メッセージを記載して commit
cum	commit -am	更新ファイルを追加しメッセージを記載して commit
co	checkout	チェックアウト
dns	diff --name-status	差分種類のみ確認
fsw	!git for-each-ref --format '%(refname:short)' refs/heads | fzf | xargs git switch	fzf を利用して switch
fsn	!git branch --no-merged origin/master --format='%(refname:short)' | fzf | xargs git switch	マージされていないブランチに fzf を利用して switch
fw	!git for-each-ref --format '%(refname:short)' refs/heads | fzf | xargs git switch	fw と同じ
graph	log --graph --date=short --decorate=short --pretty=format:'%Cgreen%h %Creset%cd %Cblue%cn %Cred%d %Creset%s'	コミットグラフを表示
l	log	ログ
l5	log --first-parent -n 5	5 個前までのログ
l10	log --first-parent -n 10	10 個前までのログ
l15	log --first-parent -n 15	15 個前までのログ
pl	pull	プル
poh	push origin HEAD	origin に現在のブランチを push
rst	reset	リセット
rh	reset --hard	ワークツリーとインデックスを指定の状態に変更（未指定:HEAD）
rmc	rm --cached	インデックスへの登録のみ削除
s	status	ステータスを表示
ss	status	ステータスを表示
sw	switch	ブランチを変更
top	rev-parse --show-toplevel	Git リポジトリのトップレベルパスを表示
wip	stash	一時領域関連
wipl	stash list	一時領域のリストを表示
wips	stash push	更新内容を一時領域に保存
wipp	stash pop	一時領域から更新を取得

Claude Code 設定

このdotfilesにはClaude Codeのグローバル設定が含まれています。 chezmoi applyにより~/.claude/に展開されます。

含まれる設定

ファイル	内容
settings.json	グローバル設定（権限、フック、モデル、プラグイン）
.mcp.json	グローバルMCPサーバー設定
CLAUDE.md	全プロジェクト共通の指示
commands/	カスタムスラッシュコマンド
stop-hook-git-check.sh	停止時のGit状態チェックフック

カスタムスラッシュコマンド

コマンド	説明
/project:init	プロジェクトのClaude Code初期設定
/mcp:aws	AWS MCPサーバーをプロジェクトに追加
/mcp:terraform	Terraform MCPサーバーをプロジェクトに追加
/docker:compose-up	Docker Composeでサービス起動
/git:sync-from-origin	現在のブランチをoriginに強制同期
/python:lint	ruffでPythonコードをlint/format
/python:test	pytestでテスト実行
/python:security	banditでセキュリティスキャン

グローバルMCPサーバー

認証不要で全プロジェクトで利用可能なMCPサーバー:

サーバー	用途
context7	ライブラリドキュメント検索
sequential-thinking	複雑な問題の段階的思考支援
serena	IDEアシスタント機能

スキルジェネレーター

Anthropic公式のスキルジェネレータープラグインが有効化されています。

使い方

1. Claude Codeで「〇〇のスキルを作成して」と依頼
2. スキルジェネレーターが自動的にスキルファイルを生成
3. 生成されたスキルは.claude/skills/に保存される

スキルとは

スキルはClaude Codeが特定のタスクを実行するための再利用可能な指示セットです。 スラッシュコマンドとは異なり、Claudeが文脈に応じて自動的に使用します。

.claude/skills/
└── my-skill/
    └── SKILL.md    # スキル定義ファイル

スキルファイルの形式

---
name: skill-name
description: スキルの説明（Claudeが使用判断に利用）
allowed-tools: Edit, Bash(npm:*)
---

# スキルの指示

ここにClaude向けの詳細な指示を記述。

権限設定

デフォルトで許可されている操作（確認なし）:

• Git操作: fetch, checkout, add, commit, branch, reset
• GitHub CLI: PR/Issue閲覧、ステータス確認
• Web検索、ドキュメント取得

確認が必要な操作（askリスト）:

• git push, git merge
• gh issue create, gh pr create, gh label create

設定のカスタマイズ

プロジェクト固有の設定は以下のファイルで上書き可能:

• .claude/settings.json - プロジェクト共有設定
• .claude/settings.local.json - ローカル専用設定（gitignore推奨）
• .claude/.mcp.json - ローカル専用MCPサーバー（gitignore推奨）

チェック内容

shfmt

シェルスクリプトファイルは更新時にshfmtによってチェックされている。

markdownlint-cli2

フォルダ内の Markdown ファイルは更新時にmarkdownlint-cli2によってチェックされている。

NOTE: markdownlintによるチェックとの違いは要検証

その他

• マイグレーション履歴は MIGRATION.md を参照
• 機能拡張や問題報告は Issues へ